Get trades

get

https://api.cert.zerohash.com/trades

Returns trade details where the requestor is the Platform, either party associated with the trade, or the account group where the trade was settled. For the party information, the asset is the settlement currency (i.e asset RECEIVED). This means in the second you are receiving USD correctly, 00SCXM is receiving BTC. The "sell" side receives the quoted currency, the "buy" side receives the underlying. Our trade structure mirrors a typical back office trade report (FIX TradeCaptureReport) and we use the concept of settlement currency for the sides to help keep our system agnostic of symbol definitions. Results are limited to the last 2 months

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

account_label

string

Filter by account label (e.g., general, sub_account_test). Account labels are used to categorize accounts under a participant. Each participant account_label maintains a separate balance and transaction history.

page

number

≥ 1

Page number for pagination (starts at 1).

market_identifier_code

string

Filters for trades within a designated market_identifier_code.

omit_market_identifier_code

string

Filters for trades excluding those from a particular market_identifier_code.

platform_code

string

Filters for trades based on the specific platform_code where the trade execution took place.

omit_platform_code

string

Filters for trades based excluding those from a particular platform_code.

trade_state

string

enum

Filters for trades based on their current trade_state.

Allowed:

settlement_state

string

enum

Filters for trades based on their current settlement_state.

Allowed:

party_code

string

Filters for trades where the provided party_code is at least one of the counterparties to a trade in the parties array.

transaction_timestamp[gt]

number

Filters for trades with a timestamp greater than the provided value, which can be defined in milliseconds or nanoseconds.

transaction_timestamp[gte]

number

Filters for trades with a timestamp greater than or equal to the provided value, which can be defined in milliseconds or nanoseconds.

transaction_timestamp[e]

number

Filters for trades with a timestamp equal to the provided value, which can be defined in milliseconds or nanoseconds.

transaction_timestamp[lt]

number

Filters for trades with a timestamp less than the provided value, which can be defined in milliseconds or nanoseconds.

transaction_timestamp[lte]

number

Filters for trades with a timestamp less than or equal to the provided value, which can be defined in milliseconds or nanoseconds.

client_trade_id

string

Filters for trades with the provided client_trade_id value.
Note:

Platforms integrated to the zerohash RFQ systems, the quote_id from the RFQ will be saved as the client_trade_id once the quote has been executed.
Platforms integrated to the zerohash CLOB, the execution_id from the order trade execution will be saved as the client_trade_id on the resulting trade.

execution_id

string

Filters for trades with the provided execution_id in either party's execution_id field.

reporting_party

string

Filters for trades based on the reporting_party associated with each trade.

settlement_schedule

string

Filters for trades based on the settlement_schedule associated with each trade.

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

200Successfully retrieved paginated list of trades with optional filters: participant_code, asset, underlying, account_label, market_identifier_code, platform_code, trade_state, settlement_state, party_code, transaction_timestamp, client_trade_id, execution_id, reporting_party, settlement_schedule.

400Bad Request

403Forbidden

404Not Found

500Internal Server Error

503Service Unavailable