ZEzerohash
CLOB

List orders

Changed on

Search for orders places on the CLOB matching the given filters.

post/orders/v1/search_orders

Request

  • Base URL
    https://api.cert.zerohash.com
  • Auth
    API key in header X-SCX-API-KEY and API key in header X-SCX-PASSPHRASE

Headers

X-SCX-SIGNEDstring required

HMAC-SHA256 signature of the request, base64-encoded. See the Authentication guide for the exact signing formula.

X-SCX-TIMESTAMPstring required
Example:1678901234

Current Unix timestamp in seconds. Must be within 60 seconds of server time or the request is rejected.

Request body

accountsstring[]

The list of account IDs to search for order updates.## Account Labels

  • Custom account label : firms/{platform_code}/accounts/{account_label}.
  • general account label : firms/{platform_code}/accounts/{participant_code}.
  • Float account : firms/00SCXM/accounts/{platform_code}.
userstring

Fully-qualified user. Format: firms/F-{platform_code}/users/{participant_code}. This value is case sensitive.

Example:- Customer User firms/F-PLAT01/users/CUST01.- Platform User firms/F-PLAT01/users/PLAT01.

client_account_idstring
client_participant_idstring
clord_idstring

Client-provided order ID. Client order ID's are unique only on open orders. If a client order ID is reused on a new order, the previous order with that ID must be fully filled or canceled before the new order can be placed. Platforms should ensure that the order_id field is is used to along with the client order ID to uniquely identify an order.

cross_idstring
end_timestring date-time

The end time for the search

host_cross_idstring
order_idstring

Unique order identifier assigned by the system.

order_state_filter'ORDER_STATE_NEW' | 'ORDER_STATE_PARTIALLY_FILLED' | 'ORDER_STATE_FILLED' | 'ORDER_STATE_CANCELED' | 'ORDER_STATE_REPLACED' | 'ORDER_STATE_REJECTED' | 'ORDER_STATE_EXPIRED' | 'ORDER_STATE_PENDING_NEW' | 'ORDER_STATE_PENDING_REPLACE' | 'ORDER_STATE_PENDING_CANCEL' | 'ORDER_STATE_PENDING_RISK'

OrderState denotes the current order state.

  • ORDER_STATE_PENDING_NEW: Order received by exchange at edges of the system but has not been processed by matching engine.
  • ORDER_STATE_PENDING_REPLACE: Cancel Replace request received by exchange at edges of the system but has not been processed by matching engine.
  • ORDER_STATE_PENDING_CANCEL: Cancel request received by exchange at edges of the system but has not been processed by matching engine.
  • ORDER_STATE_PENDING_RISK: Order is pending risk approval
page_sizeinteger

The number of results to return per page

page_tokenstring

The token for the next page of results

parent_order_idstring

The parent order ID

sidestring

The side of the order, indicating whether it is a buy or sell order.

start_timestring date-time

The start time for the search

symbolstring

The trading pair for the order.

symbol_sub_typestring

The sub-type of the symbol

type'ORDER_TYPE_MARKET_TO_LIMIT' | 'ORDER_TYPE_LIMIT' | 'ORDER_TYPE_STOP' | 'ORDER_TYPE_STOP_LIMIT'

The type of the order, indicating whether it is a limit or market order.

Example request

{
  "accounts": [
    "firms/F-{platform_code}/accounts/{account_label}"
  ],
  "user": "firms/F-PLAT01/users/CUST01",
  "clord_id": "1245567889",
  "end_time": "2023-01-01T00:00:00Z",
  "order_id": "51H5D2K2A00M",
  "order_state_filter": "ORDER_STATE_NEW",
  "page_size": 100,
  "page_token": "f81d4fae-7dec-11d0-a765-00a0c91e6bf6",
  "parent_order_id": "f81d4fae-7dec-11d0-a765-00a0c91e6bf6",
  "side": "SIDE_BUY",
  "start_time": "2023-01-01T00:00:00Z",
  "symbol": "ETH/USD",
  "symbol_sub_type": "SYMBOL_SUB_TYPE_UNDEFINED",
  "type": "ORDER_TYPE_LIMIT"
}

Response

A successful response

next_page_tokenstring

Example response

{
  "order": [
    {
      "id": "51H5D2K2A00M",
      "type": "ORDER_TYPE_LIMIT",
      "side": "SIDE_BUY",
      "order_qty": "200000",
      "symbol": "ETH/USD",
      "clord_id": "1245567889",
      "time_in_force": "TIME_IN_FORCE_GOOD_TILL_CANCEL",
      "account": "firms/F-PLAT01/accounts/CUST01-customlabel",
      "user": "firms/F-PLAT01/users/CUST01",
      "cum_qty": "0",
      "avg_px": "0",
      "leaves_qty": "200000",
      "state": "ORDER_STATE_NEW",
      "participant": "firms/F-PLAT01/users/CUST01",
      "price": "420000",
      "insert_time": "2025-09-11T18:07:22.155905574Z",
      "stop_price": "0",
      "min_qty": "0",
      "create_time": "2025-09-11T18:07:22.152425620Z",
      "commissions_basis_points": "40",
      "cash_order_qty": "0",
      "risk_check_time": "2025-09-11T18:07:22.155871055Z",
      "collateral_memo": "Fully Collateralized",
      "priority_weight": "0",
      "good_till_time": "2025-09-12T18:07:22.155905574Z",
      "context": {
        "fix_context": {
          "begin_string": "FIXT.1.1",
          "target_comp_id": "C-F-PLAT01-1",
          "sender_comp_id": "ZERO",
          "orig_clord_id": "1f19d5e1-344b-4aac-b737-a467be69e4fe",
          "target_sub_id": "1f19d5e1-344b-4aac-b737-a467be69e4fe",
          "target_location_id": "1f19d5e1-344b-4aac-b737-a467be69e4fe",
          "sender_sub_id": "CUST01"
        },
        "validation_contexts": []
      },
      "last_trade_id": "1f19d5e1-344b-4aac-b737-a467be69e4fe",
      "trigger_method": "CONDITION_TRIGGER_METHOD_UNDEFINED",
      "price_to_quantity_filled": {},
      "commission_notional_total_collected": "10",
      "self_match_prevention_instruction": "SELF_MATCH_PREVENTION_INSTRUCTION_UNDEFINED",
      "order_capacity": "ORDER_CAPACITY_INDIVIDUAL",
      "last_transact_time": "2025-09-11T18:07:22.155905574Z",
      "price_scale": "100",
      "fractional_quantity_scale": "100000000",
      "maker_commissions_basis_points": "0",
      "manual_order_indicator": "MANUAL_ORDER_INDICATOR_MANUAL"
    }
  ]
}

Changes

  • 47cf70ae701cRevision changes
    • breaking

      removed the enum value firms/F-{platform_code}/users/{account_label} of the request property

    • breaking

      removed the enum value firms/F-{platform_code}/users/{participant_code} of the request property

    • breaking

      removed the enum value firms/{zerohash}/users/{platform_code} of the request property

    • info

      removed the firms/F-{platform_code}/users/{account_label} enum value from the // response property for the response status

    • info

      removed the firms/F-{platform_code}/users/{participant_code} enum value from the // response property for the response status

    • info

      removed the firms/{zerohash}/users/{platform_code} enum value from the // response property for the response status