The Trades API lets platforms settle trades that were matched and executed outside of zerohash. You submit the details of an already-executed trade, and zerohash acts as the calculation and settlement agent — moving the underlying and quoted assets between counterparties to complete the trade.
These endpoints do not place or create a new order in the zerohash trading venue.They are for post-trade settlement only: The trade has already happened on your platform, and you're recording it with zerohash so the assets can be settled. For a full picture of how settlement works, see Settlements as a Service.
All endpoints use standard zerohash API-key authentication (a signed Signature and Timestamp).
How it works
- A trade is matched and executed on your platform.
- You submit the trade details to zerohash (counterparties, settlement schedule, amounts, and prices).
- zerohash calculates each side's settlement obligation and moves the assets — the
buyside receives theunderlying, thesellside receives thequoted_currency. - You can query the trade and its settlement status at any time.
What's available
- Submit Trade POST /trades — Submit a single executed trade for settlement. The body carries the counterparties, settlement schedule, amounts, and prices.
- Submit Batch of Trades (POST /trades/batch) — Submit many trades at once. Each entry mirrors the single-trade body, for efficient bulk settlement.
- Get Trades (GET /trades) — Retrieve trades where you are the platform, a party to the trade, or the settlement account group. Supports filters such as account label, platform code, and market identifier code, with pagination. Results cover the last two months.
- Get Trade (GET /trades/{trade_id}) — Retrieve the full details of a single trade by its zerohash-generated trade ID.
Good to know
- Settlement currency model — Trade results are expressed by settlement currency (the asset each party receives). The buy side receives the underlying; the sell side receives the quoted currency. This mirrors a standard back-office trade report (FIX
TradeCaptureReport) and keeps the API agnostic of symbol conventions. - Lookback window — GET /trades returns trades from the last two months.