Sign in
latestOpenAPI 3.0.32026-08-10336178.7 KB

6b7d8bd51050

Orders

Get order by ID

Get a specific order by order_id or client_order_id. At least one ID must be provided. Public account selectors do not require authentication; sub_account_id and the no-selector caller context do.

get/v2/order

Query parameters

symbolstring required

Trading pair symbol

order_idinteger

Server-assigned order ID

client_order_idstring

Client-provided order ID

account_idstring

Account ID for public order queries (no authentication required when provided)

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

Vault ID for public vault order queries (no authentication required when provided)

blockchainstring

Blockchain type (e.g. solana, evm, cardano). Used with blockchain_address for public queries.

blockchain_addressstring

Wallet address for public order queries. Can be used alone or with blockchain parameter.

Response

Successful response

IDinteger

Order ID

ClientOrderIDstring

Client order ID

AccountIDstring

Account ID

Symbolstring

Trading pair

CloseReasonstring

Explains why the order was closed

Side'buy' | 'sell' | 'none'

Order side

Status'pending' | 'open' | 'filled' | 'canceled' | 'untriggered' | 'rejected' | 'expired' | 'none'

Order status

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

Order type

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

Original type of a triggered conditional order

AutoCloseType'liquidation' | 'adl' | 'bankrupt' | 'if_transfer' | 'vault_withdrawal' | ''

Auto-close type (for liquidation/ADL orders)

TimeInForce'GTC' | 'IOC' | 'FOK'

Time in force

WorkingType'mark_price' | 'contract_price' | 'none'

Working type for triggers

Sizestring

Original order size

Filledstring

Filled quantity

Pricestring

Order price

StopPricestring

Stop/trigger price

BoundPricestring

Bound price for market orders

PostOnlyboolean

Post-only flag

ReduceOnlyboolean

Reduce-only flag

ClosePositionboolean

Close position flag

PriceProtectboolean

Price protection flag

STPGroupstring

Self-trade prevention group. Empty string if not set.

CreateTimestampinteger

When the API received the order (ms)

EntryTimestampinteger

When the engine received the order (ms)

EventTimestampinteger

Last event time (ms)