跳到主要内容

Open Interest Statistics

Type: NONE

Weight: 1

GET /futures/data/openInterestHist

Open-interest history aggregated by time bucket. Public endpoint: no X-MBX-APIKEY, timestamp or signature required.

Request

GET /futures/data/openInterestHist?symbol=BTCUSDT&period=5m&limit=30

Query params

NameTypeRequiredDefaultNotes
symbolstringyes
periodstringno5m5m 15m 30m 1h 2h 4h 6h 12h 1d
limitintegerno30max 500
startTime / endTimelongnoIgnored by the current implementation.

Response — 200

[
{
"symbol": "BTCUSDT",
"sumOpenInterest": "1234.567",
"sumOpenInterestValue": "1234.567",
"timestamp": "1714261200000"
}
]

sumOpenInterest and sumOpenInterestValue currently carry the same number (the bucket average of total OI in USD from fee snapshots); the token-count vs USD split is not yet computed.

Errors

HTTPcodemsg
400-1120Invalid period.
400-1121Invalid symbol.