TradePortfolio

Volume/OI Ratio

Dev

GET /volume-oi-ratio


Rolling volume-to-open-interest ratio per exchange over a configurable date range and smoothing window. The ratio signals whether a market is in an active trading regime (high ratio) or an accumulation/positioning phase (low ratio). Use it to build a multi-exchange OI efficiency chart, detect regime shifts, or filter exchanges by relative trading intensity.

Authentication

Requires Dev tier or higher. Dev: up to 30 days, window_days ≤ 7. Pro: up to 365 days, any window_days value. Requests beyond your tier's limits are clamped.

Parameters

Query parameters

NameTypeRequiredDescription
start_datestring (ISO 8601)Start of range. Defaults to 30 days ago.
end_datestring (ISO 8601)End of range. Defaults to now.
exchangesstringComma-separated exchange slugs, or all.
window_daysintRolling window in days for smoothing. Range 1–365. Defaults to 1.

Tier behavior

  • Dev: Maximum 30-day range. window_days capped at 7. Requests beyond these are clamped; a notice is included in the response.
  • Pro: Up to 365-day range. Any window_days value up to 365.

Example request

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

Example response

json
{
  "data": {
    "binance": [
      {
        "timestamp": "2026-06-01T00:00:00Z",
        "ratio": 2.35,
        "volume": 42800000000,
        "open_interest": 18200000000
      },
      {
        "timestamp": "2026-06-02T00:00:00Z",
        "ratio": 2.24,
        "volume": 39500000000,
        "open_interest": 17600000000
      }
    ],
    "bybit": [
      {
        "timestamp": "2026-06-01T00:00:00Z",
        "ratio": 2.01,
        "volume": 18900000000,
        "open_interest": 9400000000
      }
    ]
  },
  "window_days": 1,
  "notices": []
}

Errors

  • 400 Invalid date format. Response is plain text, not JSON.
  • 403 window_days or date range exceeds your tier's limits. Upgrade to Pro for 365 days.

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

Related