BUbullish
market-history-data

Get Historical Auction Results

Get historical auction results for a symbol.

  • supports pagination
  • filtering on createdAtDatetime requires additional keywords, see filtering support
get/v1/history/markets/{symbol}/auctions

Request

Path parameters

symbolstring required

market symbol. E.g. BTCUSDC

Example:BTCUSDC

market symbol, e.g. BTCUSDC

Query parameters

createdAtDatetime[gte]string date-time

ISO 8601 with millisecond as string

Example:2025-05-20T01:01:01.000Z

start timestamp of period, ISO 8601 with millisecond as string

createdAtDatetime[lte]string date-time

ISO 8601 with millisecond as string

Example:2025-05-20T01:01:01.000Z

end timestamp of period, ISO 8601 with millisecond as string

Response

OK

auctionIdstring

auction identifier

symbolstring

market symbol. E.g. BTCUSDC

crossTimestring date-time

ISO 8601 with millisecond as string

clearingPricestring

see asset value format

referencePricestring

see asset value format

pairedQuantitystring

see asset value format

imbalanceDirection'BUY' | 'SELL' | 'NONE'

final imbalance direction: BUY, SELL, or NONE

imbalanceQuantitystring

see asset value format

createdAtDatetimestring date-time

ISO 8601 with millisecond as string

Example response

[
  {
    "auctionId": "397735387747975680",
    "symbol": "BTCUSDC",
    "crossTime": "2025-05-20T01:01:01.000Z",
    "clearingPrice": "1.00000000",
    "referencePrice": "1.00000000",
    "pairedQuantity": "1.00000000",
    "imbalanceDirection": "NONE",
    "imbalanceQuantity": "1.00000000",
    "createdAtDatetime": "2025-05-20T01:01:01.000Z"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.