Skip to main content

Open Orders

GET /v1/api/openOrders

This endpoint returns the list of the client's open orders.

Headers

Header FieldTypeComments
credentials_secretJWTCreated by user for validation

Open Orders Response Message

NameTypeComments
utc_timestampintegerTime at which the message was generated by the API
open_ordersOpenOrder[]see below

OpenOrder Message

NameTypeComments
market_idstring"0" for firm order / "none" for RFQ
tradeable_entity_idintegerunique instrument id
symbolstringInstrument name e.g BTC-USD
sidestringbuy / sell
typestringLIMIT / MARKET
quantityfloat"0.1" / "0.000123" / "0.0" / "1.3456"
pricefloat"12.0" / "1.1245" / "0.000100"
order_idstringUnique Order Id generated by the exchange
client_order_idstringUnique Order Id generated by the client
order_statestringorder state
cancel_statestringcancellation state
executionsExecution[]see below

Execution Message

NameTypeComments
utc_timestampintegerExecution Time
executed_quantityfloat"0.1" / "0.000123" / "0.0" / "1.3456"
executed_pricefloat"12.0" / "1.1245" / "0.000100"
trade_idstringUnique Trade Id generated by the exchange
liquidity_flagstringadded / taken

If the order is not executed, the executions array will be empty.

Example

{
"query_open_orders_response": {
"utc_timestamp": "1670246199406663",
"open_orders": [
{
"market_id": "0",
"tradeable_entity_id": "6",
"symbol": "PTF-USD",
"type": "LIMIT",
"order_id": "exchange_generated_id",
"client_order_id": "client_generated_id",
"quantity": "1000",
"price": "0.01",
"side": "buy",
"order_state": "accepted",
"cancel_state": "none",
"executions": []
},
{
"market_id": "0",
"tradeable_entity_id": "5",
"symbol": "ETH-USD",
"type": "LIMIT",
"order_id": "exchange_generated_id",
"client_order_id": "client_generated_id",
"quantity": "10",
"price": "1500",
"side": "buy",
"order_state": "partial_fill",
"cancel_state": "none",
"executions": [
{
"utc_timestamp": "1670246760236858000",
"executed_price": "1425.0",
"executed_quantity": "0.1",
"trade_id": "2187595",
"liquidity_flag": "added"
}
]
}
]
}
}