Get Trade

GET /api/v1/trades/{tradeID}

Scope: trades:read

Returns a single trade by ID. You must own the trade.

Response

200 OK — same shape as a single element of List Trades.

404 Not Found:

{ "error": "trade not found" }

The same 404 is returned whether the trade doesn't exist or belongs to another user. This is intentional — it prevents enumeration of trade IDs.

Example

curl -H "X-API-Key: sprdr_..." \
  https://api.spreadr.xyz/api/v1/trades/00000000-0000-0000-0000-000000000000

When to use this vs WebSocket

• One-off check — GET /trades/{id} is the right tool. Single response, no connection state to manage.
• Continuous monitoring — subscribe via WebSocket with subscription: "trades", params: {trade_id: "..."}. You'll get pushed updates the instant they happen, no polling needed.