latestOpenAPI 3.0.32026-08-10336178.7 KB

6b7d8bd51050

History

Get order history

Returns persisted order history for the resolved account, newest first. Use fromOrderID for backward cursor pagination. Public account selectors do not require authentication; sub_account_id and the no-selector caller context do. Selector precedence is account_id, vault_id, blockchain address, then authenticated caller/subaccount.

get/v2/history/order

Query parameters

symbolstring

Filter by trading pair symbol

side'buy' | 'sell'

Filter by order side

type'market' | 'limit' | 'stop' | 'stop_limit' | 'take_profit' | 'take_profit_limit' | 'trailing_stop_market'

Filter by order type: market, limit, stop, stop_limit, take_profit, take_profit_limit, trailing_stop_market

statusinteger

Filter by order status integer: 1=pending, 2=open, 3=filled, 4=canceled, 5=untriggered, 6=rejected, 7=expired.

order_idinteger

Filter by specific order ID

source'twap' | 'grid' | 'copy'

Filter orders created by the specified internal strategy service.

startTimeinteger

Start time filter (Unix ms)

endTimeinteger

End time filter (Unix ms)

limitinteger

Maximum number of results. Clamped to 1000.

fromOrderIDinteger

Backward cursor: return orders with ID less than this value, newest first.

account_idstring uuid

Public account lookup by UUID. Takes precedence over every other account selector.

sub_account_idstring uuid

Select an active subaccount owned by the authenticated master account. Requires JWT or API-wallet authentication and is used only when account_id, vault_id, and blockchain_address are absent.

vault_idstring

Public vault lookup. Resolves the vault's trading account; ignored when account_id is present.

blockchain'cardano' | 'ethereum' | 'solana'

Blockchain used with blockchain_address for a direct lookup. If omitted, the server infers or searches supported chains.

blockchain_addressstring

Public wallet-address lookup (maximum 512 bytes).

Response

Order history

countinteger required

Number of orders returned