REST reference / Market data

Mark price and funding

GET/fapi/v1/premiumIndex

PublicWeight 1

Overview

Oracle marks, object with symbol or array without

Behavior and request rules

With symbol, a missing oracle tick returns 503/-1008. Without symbol, symbols without ticks are omitted, so the array may be empty.

Parameters

symbolstringoptional

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

Constraints

type: "string"

Responses

Success

One of these shapes

Variant 1 Premium

estimatedSettlePricestringrequired

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]+)?$"

indexPricestringrequired

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]+)?$"

interestRatestringrequired

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]+)?$"

lastFundingRatestringrequired

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]+)?$"

markPricestringrequired

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]+)?$"

nextFundingTimeintegerrequired

type: "integer"
format: "int64"

symbolstringrequired

type: "string"

timeintegerrequired

type: "integer"
format: "int64"

type: "object"
additionalProperties: false

Variant 2 Premium[]

Array items Premium

estimatedSettlePricestringrequired

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]+)?$"

indexPricestringrequired

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]+)?$"

interestRatestringrequired

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]+)?$"

lastFundingRatestringrequired

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]+)?$"

markPricestringrequired

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]+)?$"

nextFundingTimeintegerrequired

type: "integer"
format: "int64"

symbolstringrequired

type: "string"

timeintegerrequired

type: "integer"
format: "int64"

type: "object"
additionalProperties: false

type: "array"

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

{
  "$ref": "#/components/schemas/PremiumResult"
}

Errors, limits and retry behavior