open_interest_history_aggregated

Historical Open Interest time series for a single token across exchanges, bucketed and aggregated. Default lookback adapts to interval: 7d for 1h, 30d for 4h, 1y for 1d. Returns per-exchange breakdown plus token metadata in one call.

Usage hints:

• token_id is required (use token's CMC-style id, not the symbol)
• Use to build OI trend charts and detect leverage build-up/unwind
• Combine with cex_candle for price-vs-OI correlation analysis

REST endpoint

GET /api/v1/open-interest/history-aggregated — see REST reference.

Parameters

Name	Type	Required	Default	Description	Example
token_id	string	yes		Token id	"..."
interval	string	no	1h	Aggregation interval (5m, 15m, 1h, 4h, 1d) (default: 1h)	"1h"
from	integer	no		Start unix-ms (default: depends on interval — 7d for 1h, 30d for 4h, 1y for 1d)	0
to	integer	no		End unix-ms (default: now)	0

Example invocation

JSON-RPC tools/call payload:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "open_interest_history_aggregated",
    "arguments": {
      "token_id": "...",
      "interval": "1h"
    }
  }
}