Volume/OI Ratio
DevGET /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
| Name | Type | Required | Description |
|---|---|---|---|
start_date | string (ISO 8601) | – | Start of range. Defaults to 30 days ago. |
end_date | string (ISO 8601) | – | End of range. Defaults to now. |
exchanges | string | – | Comma-separated exchange slugs, or all. |
window_days | int | – | Rolling 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.