BUbullish
market-history-data

Get Historical Options Market Trades

Get Historical Options Market Trades by optionType. If optionType is not specified in request parameters, both CALL & PUT markets will be returned

  • On a single query request you can retrieve data over a 7 day window, with the data available for the last 90 days
  • Only max 100 data will be returned during the window
  • Default: If createdAtDatetime is omitted, the endpoint returns a rolling 7-day window of trade history, starting from the most recent trade across all options markets
get/v1/history/option-trades

Request

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

optionType'CALL' | 'PUT'

Type of Option market

Example:CALL

Specifies if it's a call (right to buy) or a put (right to sell)

Response

OK

symbolstring required

market symbol. E.g. BTC-USDC-20241004-70000-C for OPTION markets.

tradeIdstring required
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

optionType'CALL' | 'PUT' required

Type of Option market

otcTradeIdstring required

unique numeric (i64) identifier generated on Bullish side expressed as a string value

Example response

[
  {
    "symbol": "BTC-USDC-20241004-70000-C",
    "tradeId": "100020000000000060",
    "price": "1.00000000",
    "quantity": "1.00000000",
    "side": "BUY",
    "isTaker": true,
    "createdAtDatetime": "2025-05-20T01:01:01.000Z",
    "createdAtTimestamp": "1621490985000",
    "optionType": "CALL",
    "otcTradeId": "200000000000000098"
  }
]

Changes

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