BUbullish
history

Get Historical Trades

Get a list of trades based on specified filters.

  • requires bearer token in authorization header
  • On a single query request you can retrieve data over a 7 day window, with the data available for the last 90 days
  • supports pagination
  • filtering on createdAtDatetime, createdAtTimestamp requires additional keywords, see filtering support

Ratelimited: True

get/v1/history/trades

Request

Query parameters

symbolstring

market symbol. E.g. BTCUSDC

Example:BTCUSDC
orderIdstring
Example:297735387747975680

unique order ID

tradeIdstring
Example:100020000000000060

unique trade ID

clientOrderIdstring

Unique numeric (i64) identifier generated on the client side expressed as a string value

Example:299834741023572480

unique numeric (i64) identifier generated on the client side, only orderId or clientOrderId can be used

tradingAccountIdstring required

unique trading account ID

Example:111000000000001

Id of the trading account

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

otcTradeIdstring

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

Example:200000000000000098

unique Bullish otc trade id

clientOtcTradeIdstring

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

Example:20050900225

unique client otc trade id

Response

OK

tradeIdstring required
orderIdstring required
clientOrderIdstring required

Unique numeric (i64) identifier generated on the client side expressed as a string value

symbolstring required

market symbol. E.g. BTCUSDC

pricestring required

see asset value format

quantitystring required

see asset value format

quoteAmountstring required

see asset value format

baseFeestring required

see asset value format

quoteFeestring required

see asset value format

sidestring required

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

isTakerboolean required
tradeRebateAmountstring required

see asset value format

tradeRebateAssetSymbolstring required

asset symbol as denoted in the world

otcMatchIdstring required

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

otcTradeIdstring required

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

clientOtcTradeIdstring required

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

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

Example response

[
  {
    "tradeId": "100020000000000060",
    "orderId": "297735387747975680",
    "clientOrderId": "299834741023572480",
    "symbol": "BTCUSDC",
    "price": "1.00000000",
    "quantity": "1.00000000",
    "quoteAmount": "1.00000000",
    "baseFee": "1.00000000",
    "quoteFee": "1.00000000",
    "side": "BUY",
    "isTaker": true,
    "tradeRebateAmount": "1.00000000",
    "tradeRebateAssetSymbol": "USDC",
    "otcMatchId": "15",
    "otcTradeId": "200000000000000098",
    "clientOtcTradeId": "20050900225",
    "createdAtDatetime": "2025-05-20T01:01:01.000Z",
    "createdAtTimestamp": "1621490985000"
  }
]

Changes

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