Skip to main content
GET
/
api
/
v1
/
auction
Get the current batch auction.
curl --request GET \
  --url https://api.cow.fi/mainnet/api/v1/auction
{
  "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.

​
id
integer

The unique identifier of the auction. Increment whenever the backend creates a new auction.

​
block
integer

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.

​
orders
object[]

The solvable orders included in the auction.

​
prices
object

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.

​
surplusCapturingJitOrderOwners
string[]

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