Exchange OI Totals

Dev

GET /oi/exchange-totals

Aggregated open interest totals per exchange over a configurable date range, with optional unit conversion to contracts. Returns hourly buckets for ranges under 24 hours, daily otherwise. Use it to chart OI growth trends across venues, compare relative positioning between exchanges, or detect unusual OI accumulation.

Authentication

Requires Dev tier or higher. Dev: maximum 30 days. Pro: unlimited depth. Requests beyond your tier's limit are clamped; a notice is included in the response.

Parameters

Query parameters

Name	Type	Required	Description
`start_date`	string (ISO 8601)	–	Start of range. Defaults to 7 days ago.
`end_date`	string (ISO 8601)	–	End of range. Defaults to now.
`exchanges`	string	–	Comma-separated exchange slugs, or all. Defaults to all.
`unit`	string	–	usd (default) or coins.

Tier behavior

Dev: Maximum 30 days lookback. Requests beyond this are clamped; the response includes a notice.
Pro: Unlimited historical depth.

Example request

bash

curl -H "X-Api-Key: lk_live_your_key_here" \
  "https://api.loris.tools/oi/exchange-totals?exchanges=binance,bybit&start_date=2026-06-01"

Example response

json

{
  "data": [
    {
      "timestamp": "2026-06-01T00:00:00Z",
      "exchange": "binance",
      "total_open_interest_usd": 18200000000,
      "symbol_count": 312
    },
    {
      "timestamp": "2026-06-01T00:00:00Z",
      "exchange": "bybit",
      "total_open_interest_usd": 9400000000,
      "symbol_count": 287
    }
  ],
  "notices": [],
  "unit": "usd"
}

Errors

400 — Invalid date format or unknown exchange slug.

For authentication errors (401) and rate limit responses (429), see Errors.