List orders

post

https://api.cert.zerohash.com/orders/v1/search_orders

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

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

To ensure optimal query performance, the POST /orders/v1/search_orders endpoint strictly filters results to the last 14 days.

Orders placed older than 14 days will not be returned in the payload. If your application requires historical order data beyond this 14 day window, please ensure you are persisting incoming order payloads to your own database

Body Params

accounts

array of strings

accounts

user

string

enum

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

Clearing House Designations

USA: 00SXCM (ZH Clearing House)
EU: ZHDSEU

Prefunded Model

USD balances are ledgered directly to the participants on their CLOB account.
- Participants will be credit checked against their available balance on the zerohash platform.
Accounts must be registed with the prefunded field as true on the POST /accounts endpoint.
Trade settlement is handled directly between participants and occurs instantly upon execution.

Novated Model

Utilizes a central float account to manage the cumulative buying power of your customers.
- USD balance is ledgeder to the platforms float account.
- USD credit checks must be performed by the platform prior to order placement.
Accounts must be registed with the prefunded field as false on the POST /accounts endpoint.
Allows platforms to manage the buying power of their customers effectively, allowing for better operational efficiency.

Allowed:

client_account_id

string

client_participant_id

string

clord_id

string

Client-provided order ID.

cross_id

string

end_time

date-time

The end time for the search

host_cross_id

string

order_id

string

Unique order identifier.

order_state_filter

string

enum

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_size

integer

The number of results to return per page

page_token

string

The token for the next page of results

parent_order_id

string

The parent order ID

side

string

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

start_time

date-time

The start time for the search

symbol

string

The trading pair for the order.

symbol_sub_type

string

The sub-type of the symbol

type

string

enum

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

Allowed:

Headers

X-SCX-SIGNED

string

required

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

X-SCX-TIMESTAMP

string

required

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

Responses

Clearing House Designations

Prefunded Model

Novated Model

200A successful response

defaultAn error occurred