BUbullish
trades

Get Trades

Get a list of trades based on specified filters.

  • requires bearer token in authorization header
  • Only the last 24 hours of data is available for querying
  • supports pagination
  • filtering on createdAtDatetime, createdAtTimestamp requires additional keywords, see filtering support

Ratelimited: True

get/v1/trades

Request

Query parameters

symbolstring

market symbol. E.g. BTCUSDC

Example:BTCUSDC
orderIdstring
Example:297735387747975680

unique order 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

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.