Trade

Get Open & Closed Orders

Changed on

Primarily query unfilled or partially filled orders in real-time, but also supports querying recent 500 closed status (Cancelled, Filled) orders. Please see the usage of request param open_only.

get/api/v1/order/realtime

Request

Query parameters

sub_account_addressstring required
symbolstring
Example:BTC-USDCx

Symbol name

order_idstring uuid

Order ID

order_link_idstring

User customised order ID

open_onlyboolean
  • true (default): query open status orders (New or PartiallyFilled).
  • false: query a maximum of recent 500 closed status orders (Cancelled, Rejected, Filled).
order_filterOrderFilter (unresolved $ref)
limitinteger nullable
cursorstring nullable

Response

Orders

next_page_cursorstring required

Example response

{
  "list": [
    {
      "created_time": "1672531200000",
      "expire_time": "1672531200000",
      "symbol": "BTC-USDCx",
      "updated_time": "1672531200000"
    }
  ]
}

Changes

    • warning

      added the new EcPriceNotMultipleOfTick enum value to the ////// response property for the response status

    • warning

      added the new EcQtyAboveMax enum value to the ////// response property for the response status

    • warning

      added the new EcQtyBelowMin enum value to the ////// response property for the response status

    • warning

      added the new EcQtyNotMultipleOfLot enum value to the ////// response property for the response status

    • info

      removed the EcEcInvalidQty enum value from the ////// response property for the response status

    • warning

      added the new EcReduceOnlyMode enum value to the ////// response property for the response status

    • warning

      added the new EcTradingHalted enum value to the ////// response property for the response status