ZEzerohash
Trades

Get trade

Retrieves trade details for a specific trade.

get/trades/{trade_id}

Request

  • Base URL
    https://api.cert.zerohash.com
  • URL
    https://api.cert.zerohash.com/trades/{trade_id}
  • Auth
    API key in header X-SCX-API-KEY and API key in header X-SCX-PASSPHRASE

Path parameters

trade_idstring required

The zerohash generated ID associated with a trade

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.

Response

Successfully retrieved trade. Including amounts, prices, settlement details, and counterparty information.

Example response

{
  "message": {
    "batch_trade_id": null,
    "trade_id": "78260d47-336e-4253-b800-d528894253b2",
    "client_trade_id": "40b402b0-22ad-4d67-ae8c-7964be34ee29",
    "trade_state": "terminated",
    "market_identifier_code": "SCXM",
    "trade_reporter_code": "00SCXM",
    "symbol": "BTC/USD",
    "trade_quantity": "0.00059241",
    "trade_price": "81531.3718539524991138",
    "trade_type": "regular",
    "physical_delivery": true,
    "comment": "",
    "last_update": 1778771702391,
    "transaction_timestamp": 1778771677000,
    "accepted_timestamp": 1778771677972,
    "defaulted_timestamp": null,
    "settled_timestamp": 1778771702360,
    "expiry_timestamp": null,
    "settlement_timestamp": null,
    "settlement_price_index_id": null,
    "contract_size": 1,
    "underlying": "BTC",
    "quoted_currency": "USD",
    "trade_reporter": "00SCXM",
    "platform_code": "00SCXM",
    "product_type": "spot",
    "parties_anonymous": false,
    "bank_fee": null,
    "reporting_party": "00SCXM",
    "settlement_schedule": null,
    "parties": [
      {
        "settling": true,
        "participant_code": "CUST01",
        "side": "buy",
        "asset": "BTC",
        "amount": "0.00059241",
        "liquidity_indicator": null,
        "execution_id": "",
        "order_id": "",
        "obligations_outstanding_timestamp": null,
        "current_obligations_met_timestamp": null,
        "settlement_state": "settled",
        "client_order_id": "",
        "collateral_percentage": null,
        "account_label": "general",
        "account_profile": null,
        "trader": null,
        "zrn": null,
        "manual_order_indicator": null
      },
      {
        "settling": true,
        "participant_code": "00SCXM",
        "side": "sell",
        "asset": "USD",
        "amount": "48.3",
        "liquidity_indicator": null,
        "execution_id": "",
        "order_id": "",
        "obligations_outstanding_timestamp": null,
        "current_obligations_met_timestamp": null,
        "settlement_state": "settled",
        "client_order_id": "",
        "collateral_percentage": null,
        "account_label": "inventory",
        "account_profile": null,
        "trader": null,
        "zrn": null,
        "manual_order_indicator": null
      }
    ],
    "session_id": "20260514151438",
    "fees": [
      {
        "name": "LiquidityFee",
        "amount": "1.7"
      }
    ],
    "issuer_fee_rate": "0",
    "issuer_fee_amount": "0",
    "issuer_fee_payor_type": null,
    "payment_processor": null,
    "network_fee_notional": null,
    "network_fee_quantity": null,
    "total_notional": "50.00",
    "asset_cost_notional": "48.30",
    "origin": "rest_api",
    "spread_notional": "0.12075",
    "spread_bps": "25"
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.