TradePortfolio

Coin OI

Free

GET /oi/coin


OI timeseries for all exchanges reporting a given base coin, aggregated per venue. Returns a chronological series of daily snapshots showing how each exchange's OI on that coin has moved over the selected window. Use it to build per-coin OI charts, analyze cross-exchange divergences, or spot positioning shifts before price moves.

Authentication

Available on all tiers. Free tier: BTC and ETH only — requests for other coins return 403. Dev: all coins, 30-day max lookback. Pro: all coins, up to 90 days and beyond.

Parameters

Query parameters

NameTypeRequiredDescription
coinstringBase symbol. Defaults to BTC.
start_datestring (ISO 8601)Start of range. Defaults to 7 days ago.
end_datestring (ISO 8601)End of range. Defaults to now.
unitstringusd (default) or coins.

Tier behavior

  • Free: BTC and ETH only. Requests for any other coin return 403 with required_tier: dev.
  • Dev: All coins. Maximum 30-day lookback. Requests beyond this are clamped with a notice.
  • Pro: All coins. Up to 90 days and beyond.

Example request

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

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"
}

Errors

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

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

Related