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 lookback. Requests beyond your tier's limit are clamped; a notice is included in the response.

Parameters

Query parameters

Name	Type	Required	Description
`range`	string	–	Preset lookback: 4h, 12h, 1d, 3d, 7d, 14d, 30d, 90d, or all. Defaults to 7d. Do not combine with start/end.
`start`	string (ISO 8601)	–	Custom range start. Date-only strings are accepted. start_date is accepted as a legacy alias.
`end`	string (ISO 8601)	–	Custom range end. Date-only strings are accepted. Defaults to now when start is provided. end_date is accepted as a legacy alias.
`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 lookback.

Example request

bash

curl -H "X-Api-Key: lk_live_your_key_here" \
  "https://api.loris.tools/oi/exchange-totals?range=30d&exchanges=binance,bybit"

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",
	  "range": "30d",
	  "resolution": "1d"
	}

Errors

400 — Invalid range, invalid date format, mixed range plus start/end, or unknown exchange slug.

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