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
| Name | Type | Required | Default | Notes |
|---|---|---|---|---|
symbol | string | yes | — | |
period | string | no | 5m | 5m 15m 30m 1h 2h 4h 6h 12h 1d |
limit | integer | no | 30 | max 500 |
startTime / endTime | long | no | — | Ignored 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
| HTTP | code | msg |
|---|---|---|
400 | -1120 | Invalid period. |
400 | -1121 | Invalid symbol. |