ZEzerohash
CLOB

List open orders

Changed on

Returns snapshot of working orders the CLOB matching the given filters.

post/orders/v1/get_open_orders

Request

  • Base URL
    https://api.cert.zerohash.com
  • URL
    https://api.cert.zerohash.com/orders/v1/get_open_orders
  • 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 on working orders.## 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.

symbolsstring[]

The array of symbols to subscribe to for market data

Example request

{
  "accounts": [
    "PAR001"
  ],
  "user": "firms/F-PLAT01/users/CUST01",
  "symbols": [
    "ETH/USD"
  ]
}

Response

A successful response

Example response

{
  "orders": [
    {
      "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