REST reference / Market data

Open interest

GET/fapi/v1/openInterest
PublicWeight 1

Overview

Last-good upstream open interest cache

Parameters

symbolstringrequired

Listed symbol, for example BTCUSDT. Unlisted symbols return -1121.

Constraints
type
"string"

Responses

Success

openIntereststringrequired

Decimal encoded as a string. Precision follows the symbol or the field's documented scale. Never convert to a binary floating-point number for signing or accounting.

type
"string"
pattern
"^-?[0-9]+(\\.[0-9]+)?$"
symbolstringrequired
type
"string"
timeintegerrequired
type
"integer"
format
"int64"
type
"object"
additionalProperties
false
Response headers
X-MBX-USED-WEIGHT-1M

Per-IP admitted request weight in the current minute. Requests admitted by the limiter count even if authentication or validation later fails.

Raw response schema
Response schema
{
  "$ref": "#/components/schemas/OpenInterest"
}
Errors, limits and retry behavior