v1

latestOpenAPI 3.1.02026-07-241653251.3 MB

Trades

Get trade

Retrieves trade details for a specific trade.

get/trades/{trade_id}

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": "DL1BXT",
        "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"
  }
}