BUbullish
market-history-data

Get Historical Market Trades

Get Historical Market Trades by Market Symbol. Supports querying of up to 7 days of data at a time.

  • supports pagination

Ratelimited: False

  • On a single query request you can retrieve data over a 7 day window, with the data available for the last 90 days
get/v1/history/markets/{symbol}/trades

Request

Path parameters

symbolstring required

market symbol. E.g. BTCUSDC

Example:BTCUSDC

symbol to get

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

tradeIdstring required
symbolstring required

market symbol. E.g. BTCUSDC

pricestring required

see asset value format

quantitystring required

see asset value format

sidestring required

order side can have the following string values "BUY", "SELL"

isTakerboolean required
createdAtDatetimestring date-time required

ISO 8601 with millisecond as string

createdAtTimestampstring string required

unsigned 64 bit integer value which is the number of milliseconds since EPOCH expressed as string

quoteAmountstring

see asset value format

auctionIdstring

unique Bullish auction identifier. Present only for auction trades

Example response

[
  {
    "tradeId": "100020000000000060",
    "symbol": "BTCUSDC",
    "price": "1.00000000",
    "quantity": "1.00000000",
    "side": "BUY",
    "isTaker": true,
    "createdAtDatetime": "2025-05-20T01:01:01.000Z",
    "createdAtTimestamp": "1621490985000",
    "quoteAmount": "1.00000000",
    "auctionId": "397735387747975680"
  }
]

Changes

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