BUbullish
history

Get Historical Orders

Retrieve a list of orders placed by a trading account with specified filters.

  • On a single query request you can retrieve data over a 7 day window, with the data available for the last 90 days

This endpoint requires authentication and supports pagination. To filter by createdAtDatetime and createdAtTimestamp, additional parameters are required. For detailed instructions, see the Filtering Support section. Additionally, this endpoint is subjected to rate limiting.

get/v2/history/orders

Request

Query parameters

symbolstring

market symbol. E.g. BTCUSDC

Example:BTCUSDC
orderIdstring
Example:297735387747975680
clientOrderIdstring

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

Example:299834741023572480
side'BUY' | 'SELL'
Example:BUY

order side

status'OPEN' | 'CLOSED' | 'CANCELLED' | 'REJECTED'
Example:OPEN

order status

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

Response

OK

clientOrderIdstring required

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

orderIdstring required
symbolstring required

market symbol. E.g. BTCUSDC

pricestring required

see asset value format

averageFillPricestring required

see asset value format

stopPricestring required

see asset value format

allowBorrowboolean required

indicates if the order was allowed to borrow (does not indicate that borrowing occurred)

quantitystring required

see asset value format

quantityFilledstring required

see asset value format

quoteAmountstring required

see asset value format

baseFeestring required

see asset value format

quoteFeestring required

see asset value format

borrowedBaseQuantitystring

see asset value format

borrowedQuoteQuantitystring

see asset value format

isLiquidationboolean required

indicates if the order was executed as a liquidation order

sidestring required

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

typestring required

order type can have the following string values "LMT", "MKT", "STOP_LIMIT", "POST_ONLY". "MKT" and "STOP_LIMIT" are not applicable for Options

timeInForcestring required

time in force can have the following string values "GTC", "FOK", "IOC", "GTX" (Good Till Crossing - for auction orders), see details

statusstring required

order status can have the following string values "OPEN", "CLOSED", "CANCELLED", "REJECTED"

statusReasonstring required

status reason, describes why the order is in a specific state

statusReasonCodestring required

status reason code, see details

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

[
  {
    "clientOrderId": "299834741023572480",
    "orderId": "297735387747975680",
    "symbol": "BTCUSDC",
    "price": "1.00000000",
    "averageFillPrice": "1.00000000",
    "stopPrice": "1.00000000",
    "quantity": "1.00000000",
    "quantityFilled": "1.00000000",
    "quoteAmount": "1.00000000",
    "baseFee": "1.00000000",
    "quoteFee": "1.00000000",
    "borrowedBaseQuantity": "1.00000000",
    "borrowedQuoteQuantity": "1.00000000",
    "side": "BUY",
    "type": "LMT",
    "timeInForce": "GTX",
    "status": "OPEN",
    "statusReason": "User cancelled",
    "statusReasonCode": "1002",
    "createdAtDatetime": "2025-05-20T01:01:01.000Z",
    "createdAtTimestamp": "1621490985000"
  }
]

Changes

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