Per-venue spot rankings — 24h volume, pair count, share-of-total.

Spot equivalent of `/api/v1/exchanges`, scoped to the spot slice of the trade table.

Query parameters

All query parameters are optional unless marked required.

Response shape

Always wrapped in the standard envelope. Nullable fields are explicitly marked — treat missing numeric data as a real data-source gap, not as an error.

// Wrapped in the standard envelope:
// {
//   data: /* shape below */,
//   meta?: { total?: number; limit?: number; offset?: number; ... }
// }

Array<{
  source: string;
  volume24hUsd: number;
  tradeCount: number;
  pairCount: number;
  coinCount: number;
  sharePct: number;
  lastTs: number | null;
}>

Example

Copy the curl, replace YOUR_KEY with a real key from your dashboard, and run.

curl -sS "http://localhost:3000/api/v1/spot/exchanges" \
  -H "Authorization: Bearer cg_live_YOUR_KEY"

{
  "data": [
    { "source": "binance", "volume24hUsd": 8200000000, "tradeCount": 420000, "pairCount": 210, "coinCount": 185, "sharePct": 35.1, "lastTs": 1744834800000 }
  ],
  "meta": { "total": 1, "limit": 50 }
}