Cross-exchange funding matrix (coins × exchanges) + current extremes.

Identical payload to the matrix arm of `/api/v1/funding-rates` — exposed here under the futures namespace so clients that group by product can find it. Ideal for spotting cross-venue funding divergence in one round trip.

Query parameters

This endpoint takes no query parameters.

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; ... }
// }

{
  coins: string[];
  exchanges: string[];
  matrix: Record<string, Record<string, { rate: number; ts: number; intervalHours: number | null } | null>>;
  newestTs: number | null;
  extremes: { highest: Array<object>; lowest: Array<object>; average: 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/funding/heatmap" \
  -H "Authorization: Bearer cg_live_YOUR_KEY"

{
  "data": {
    "coins": ["BTC", "ETH"],
    "exchanges": ["binance_futures", "bybit", "okx", "htx_linear_swap", "hyperliquid"],
    "matrix": { "BTC": { "binance_futures": { "rate": 0.0001, "ts": 1744834800000, "intervalHours": 8 } } },
    "newestTs": 1744834800000,
    "extremes": { "highest": [], "lowest": [], "average": 0.00005 }
  },
  "meta": { "total": 2 }
}