Skip to main content

Open Interest History

Historical open-interest series. Passthrough of Binance USDⓈ-M Futures /futures/data/openInterestHist.

Endpoint

GET /openInterestHist

Authentication: Public.

Query parameters

NameTypeRequiredDefaultNotes
symbolstringYesUppercase futures symbol.
periodstringNo5mOne of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d.
limitintegerNo10Max per Binance is 500.

Response — 200 OK

Array, Binance shape:

[
{
"symbol": "BTCUSDT",
"sumOpenInterest": "12345.678",
"sumOpenInterestValue": "827654321.00",
"timestamp": 1745920800000
}
]

Errors

HTTPCause
422Missing symbol.
502Upstream Binance request failed.

Example

curl -s "https://api.pipai.org/openInterestHist?symbol=BTCUSDT&period=1h&limit=24"