---
updatedAt: 2026-06-11T01:29:02.000Z
agentTools:
  projectIndex: https://docs.zerohash.com/llms.txt
---

# Post Trade Settlement 

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](https://docs.zerohash.com/docs/settlements-as-a-service).

All endpoints use standard zerohash API-key authentication (a signed `Signature` and `Timestamp`).

## How it works

1. A trade is matched and executed on your platform.
2. You submit the trade details to zerohash (counterparties, settlement schedule, amounts, and prices).
3. zerohash calculates each side's settlement obligation and moves the assets — the `buy` side receives the `underlying`, the `sell` side receives the `quoted_currency`.
4. You can query the trade and its settlement status at any time.

## What's available

* **Submit Trade** <Anchor target="_blank" href="ref:post_trades">POST /trades </Anchor>— Submit a single executed trade for settlement. The body carries the counterparties, settlement schedule, amounts, and prices.
* **Submit Batch of Trades** ([POST /trades/batch](https://docs.zerohash.com/zerohash/reference/post_trades-batch)) — Submit many trades at once. Each entry mirrors the single-trade body, for efficient bulk settlement.
* **Get Trades** ([GET /trades](https://docs.zerohash.com/zerohash/reference/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}](https://docs.zerohash.com/zerohash/reference/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](https://docs.zerohash.com/zerohash/reference/get_trades) returns trades from the last two months.

<br />