Get the current batch auction.
The current batch auction that solvers should be solving right now. This includes:
- A list of solvable orders. * The block on which the batch was created.
- Prices for all tokens being traded (used for objective value computation).
Note: This endpoint is currently permissioned. Reach out in discord if you need access.
GET
/
api
/
v1
/
auction
Get the current batch auction.
curl --request GET \
--url https://api.cow.fi/mainnet/api/v1/auctionimport requests
url = "https://api.cow.fi/mainnet/api/v1/auction"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.cow.fi/mainnet/api/v1/auction', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.cow.fi/mainnet/api/v1/auction",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.cow.fi/mainnet/api/v1/auction"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.cow.fi/mainnet/api/v1/auction")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cow.fi/mainnet/api/v1/auction")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"id": 123,
"block": 123,
"orders": [
{
"uid": "0xff2e2e54d178997f173266817c1e9ed6fee1a1aae4b43971c53b543cffcc2969845c6f5599fbb25dbdd1b9b013daf85c03f3c63763e4bc4a",
"sellToken": "0x6810e776880c02933d47db1b9fc05908e5386b96",
"buyToken": "0x6810e776880c02933d47db1b9fc05908e5386b96",
"sellAmount": "1234567890",
"buyAmount": "1234567890",
"created": "123456",
"validTo": 123,
"kind": "buy",
"receiver": "0x6810e776880c02933d47db1b9fc05908e5386b96",
"owner": "0x6810e776880c02933d47db1b9fc05908e5386b96",
"partiallyFillable": true,
"executed": "1234567890",
"preInteractions": [
{
"target": "0x6810e776880c02933d47db1b9fc05908e5386b96",
"value": "1234567890",
"callData": "0xca11da7a"
}
],
"postInteractions": [
{
"target": "0x6810e776880c02933d47db1b9fc05908e5386b96",
"value": "1234567890",
"callData": "0xca11da7a"
}
],
"sellTokenBalance": "erc20",
"buyTokenBalance": "erc20",
"class": "market",
"appData": "0x0000000000000000000000000000000000000000000000000000000000000000",
"signature": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"protocolFees": [
{
"factor": 0.5,
"maxVolumeFactor": 0.5
}
],
"quote": {
"sellAmount": "1234567890",
"buyAmount": "1234567890",
"fee": "1234567890"
}
}
],
"prices": {},
"surplusCapturingJitOrderOwners": [
"0x6810e776880c02933d47db1b9fc05908e5386b96"
]
}Response
200 - application/json
Batch auction.
A batch auction for solving.
The unique identifier of the auction. Increment whenever the backend creates a new auction.
The block number for the auction. Orders and prices are guaranteed to be valid on this block. Proposed settlements should be valid for this block as well.
The solvable orders included in the auction.
Show child attributes
Show child attributes
The reference prices for all traded tokens in the auction as a mapping from token addresses to a price denominated in native token (i.e. 1e18 represents a token that trades one to one with the native token). These prices are used for solution competition for computing surplus and converting fees to native token.
Show child attributes
Show child attributes
List of addresses on whose surplus will count towards the objective value of their solution (unlike other orders that were created by the solver).
20 byte Ethereum address encoded as a hex with 0x prefix.
Last modified on March 17, 2026
Was this page helpful?
Get the current batch auction.
curl --request GET \
--url https://api.cow.fi/mainnet/api/v1/auctionimport requests
url = "https://api.cow.fi/mainnet/api/v1/auction"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.cow.fi/mainnet/api/v1/auction', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.cow.fi/mainnet/api/v1/auction",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.cow.fi/mainnet/api/v1/auction"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.cow.fi/mainnet/api/v1/auction")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cow.fi/mainnet/api/v1/auction")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"id": 123,
"block": 123,
"orders": [
{
"uid": "0xff2e2e54d178997f173266817c1e9ed6fee1a1aae4b43971c53b543cffcc2969845c6f5599fbb25dbdd1b9b013daf85c03f3c63763e4bc4a",
"sellToken": "0x6810e776880c02933d47db1b9fc05908e5386b96",
"buyToken": "0x6810e776880c02933d47db1b9fc05908e5386b96",
"sellAmount": "1234567890",
"buyAmount": "1234567890",
"created": "123456",
"validTo": 123,
"kind": "buy",
"receiver": "0x6810e776880c02933d47db1b9fc05908e5386b96",
"owner": "0x6810e776880c02933d47db1b9fc05908e5386b96",
"partiallyFillable": true,
"executed": "1234567890",
"preInteractions": [
{
"target": "0x6810e776880c02933d47db1b9fc05908e5386b96",
"value": "1234567890",
"callData": "0xca11da7a"
}
],
"postInteractions": [
{
"target": "0x6810e776880c02933d47db1b9fc05908e5386b96",
"value": "1234567890",
"callData": "0xca11da7a"
}
],
"sellTokenBalance": "erc20",
"buyTokenBalance": "erc20",
"class": "market",
"appData": "0x0000000000000000000000000000000000000000000000000000000000000000",
"signature": "0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"protocolFees": [
{
"factor": 0.5,
"maxVolumeFactor": 0.5
}
],
"quote": {
"sellAmount": "1234567890",
"buyAmount": "1234567890",
"fee": "1234567890"
}
}
],
"prices": {},
"surplusCapturingJitOrderOwners": [
"0x6810e776880c02933d47db1b9fc05908e5386b96"
]
}