Open Interest History
Historical open-interest series. Passthrough of Binance USDⓈ-M Futures /futures/data/openInterestHist.
Endpoint
GET /openInterestHist
Authentication: Public.
Query parameters
| Name | Type | Required | Default | Notes |
|---|---|---|---|---|
symbol | string | Yes | — | Uppercase futures symbol. |
period | string | No | 5m | One of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d. |
limit | integer | No | 10 | Max per Binance is 500. |
Response — 200 OK
Array, Binance shape:
[
{
"symbol": "BTCUSDT",
"sumOpenInterest": "12345.678",
"sumOpenInterestValue": "827654321.00",
"timestamp": 1745920800000
}
]
Errors
| HTTP | Cause |
|---|---|
422 | Missing symbol. |
502 | Upstream Binance request failed. |
Example
curl -s "https://api.pipai.org/openInterestHist?symbol=BTCUSDT&period=1h&limit=24"