Cross-exchange OI pivot — per-venue sum, share, instrument count.

Who's holding the open interest right now? Ranks every exchange by aggregate OI (USD). Pass `coin` to scope to one base.

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;
  oiUsd: number;
  sharePct: number;
  instrumentCount: 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/futures/oi/by-exchange?coin=BTC" \
  -H "Authorization: Bearer cg_live_YOUR_KEY"

{
  "data": [
    { "source": "binance_futures", "oiUsd": 12410200000, "sharePct": 42.1, "instrumentCount": 1, "lastTs": 1744834800000 }
  ],
  "meta": { "total": 1, "coin": "BTC", "aggregateUsd": 29500000000 }
}