GET
/api/v1/futures/oi/dominanceStartup tier+ · 80 req/minCoin-level OI dominance — share of aggregate OI per coin.
Ranks coins by their share of total derivatives open interest. Useful for BTC-dominance charts and for spotting alts pulling OI.
Query parameters
All query parameters are optional unless marked required.
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| limit | number | optional | 20 | Coins to return. Max 100. |
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.
data payloadtypescript
// Wrapped in the standard envelope:
// {
// data: /* shape below */,
// meta?: { total?: number; limit?: number; offset?: number; ... }
// }
{
totals: {
totalUsd: number;
changePct24h: number | null;
dominantExchange: string | null;
dominantSharePct: number;
instrumentCount: number;
sourceCount: number;
lastTs: number | null;
};
coins: Array<{
base: string;
oiUsd: number;
dominancePct: number;
change24hPct: number | null;
dominantExchange: string;
dominantSharePct: number;
exchangeCount: number;
}>;
}Example
Copy the curl, replace YOUR_KEY with a real key from your dashboard, and run.
Requestbash
curl -sS "http://localhost:3000/api/v1/futures/oi/dominance?limit=5" \
-H "Authorization: Bearer cg_live_YOUR_KEY"Responsejson
{
"data": {
"totals": {
"totalUsd": 29500000000,
"changePct24h": 2.1,
"dominantExchange": "binance_futures",
"dominantSharePct": 42.1,
"instrumentCount": 380,
"sourceCount": 5,
"lastTs": 1744834800000
},
"coins": [
{ "base": "BTC", "oiUsd": 14200000000, "dominancePct": 48.1, "change24hPct": 1.8, "dominantExchange": "binance_futures", "dominantSharePct": 41.0, "exchangeCount": 5 }
]
},
"meta": { "total": 1, "limit": 5 }
}Next
Check the error code reference, or get an API key to try the request against your own account.