TradePortfolio
DocsSymbol OI Timeseries
Docs

Symbol OI Timeseries

Free

GET /oi/{symbol}/timeseries

OI timeseries for all exchanges reporting a given base symbol, aggregated per venue. Returns clean hourly buckets for windows up to 7 days, and daily buckets for longer windows. Use it to build per-symbol OI charts, analyze cross-exchange divergences, or spot positioning shifts before price moves. Legacy /oi/coin remains available until July 21, 2026.

Authentication

Available on all tiers. Free tier: BTC and ETH only — requests for other symbols return 403. Dev: all symbols, 30-day max lookback. Pro: all symbols, full available historical lookback.

Parameters

Query parameters

NameTypeRequiredDescription
symbolstring✓Base symbol in the path, for example BTC or ETH.
startstring (ISO 8601)–Custom range start. Date-only strings are accepted. start_date is accepted as a legacy alias.
endstring (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.
rangestring–Preset lookback: 4h, 12h, 1d, 3d, 7d, 14d, 30d, 90d, or all. Defaults to 7d. Do not combine with start/end.
unitstring–usd (default) or coins.
exchangesstring–Comma-separated exchange slugs. Required when requesting an explicit resolution.
resolutionstring–Set to 1h for observation-time hourly chart data. Omit it to preserve adaptive hourly/daily behavior.

Tier behavior

  • Free: BTC and ETH only. Requests for any other symbol return 403 with required_tier: dev.
  • Dev: All symbols. Maximum 30-day lookback. Requests beyond this are clamped with a notice.
  • Pro: All symbols. Full available historical lookback.

Example request

bash
curl -H "X-Api-Key: lk_live_your_key_here" \
  "https://api.loris.tools/oi/ETH/timeseries?start=2026-06-01&end=2026-06-15"

Example response

json
{
  "data": [
    {
      "timestamp": "2026-06-01T00:00:00Z",
      "exchange": "binance",
      "open_interest_usd": 5800000000
    },
    {
      "timestamp": "2026-06-01T00:00:00Z",
      "exchange": "bybit",
      "open_interest_usd": 2100000000
    },
    {
      "timestamp": "2026-06-02T00:00:00Z",
      "exchange": "binance",
      "open_interest_usd": 5950000000
    }
  ],
	  "notices": [],
	  "coin": "ETH",
	  "unit": "usd",
	  "range": "custom",
	  "resolution": "1d"
	}

Errors

  • 403 — Free tier requesting a symbol other than BTC or ETH. Upgrade to Dev.

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

Related