Market Data

Endpoint

ADL Risk

Query the symbol-level ADL risk rating.

The ADL risk rating measures the likelihood of ADL during liquidation, and the rating takes into account the insurance fund balance, position concentration on the symbol, order book depth, price volatility, average leverage, unrealized PnL, and margin utilization at the symbol level.

The rating can be high, medium and low, and is updated every 30 minutes.

GET

/fapi/v1/symbolAdlRisk

https://fapi.binance.com

ADL Risk › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

ADL Risk › Query Parameters

symbol

string

Symbol

Example: BTCUSDT

ADL Risk › Responses

200

ADL Risk

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = array

Properties for Variant 1:

symbol

string

Example: BTCUSDT

adlRisk

string

ADL Risk rating

Example: low

updateTime

integer · int64

Example: 1597370495002

GET/fapi/v1/symbolAdlRisk

curl --request GET \
  --url https://fapi.binance.com/fapi/v1/symbolAdlRisk

Example Responses

{
  "symbol": "BTCUSDT",
  "adlRisk": "low",
  "updateTime": 1597370495002
}

application/json

Basis

Query future basis

GET

/futures/data/basis

https://fapi.binance.com

Basis › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight0

Basis › Query Parameters

pair

string · required

Example: BTCUSDT

contractType

string · enum · required

Enum values:

PERPETUAL

CURRENT_QUARTER

NEXT_QUARTER

Example: PERPETUAL

period

string · enum · required

Enum values:

15m

30m

12h

Example: 5m

limit

integer · int64 · max: 500

Example: 30

Default: 30

startTime

integer · int64

Example: 1623319461670

endTime

integer · int64

Example: 1641782889000

Basis › Responses

200

Basis

object

indexPrice

string

Example: 34400.15945055

contractType

string

Example: PERPETUAL

basisRate

string

Example: 0.0004

futuresPrice

string

Example: 34414.10

annualizedBasisRate

string

Example:

basis

string

Example: 13.94054945

pair

string

Example: BTCUSDT

timestamp

integer · int64

Example: 1698742800000

GET/futures/data/basis

curl --request GET \
  --url 'https://fapi.binance.com/futures/data/basis?pair=%3Cstring%3E&contractType=%3Cstring%3E&period=%3Cstring%3E'

Example Responses

[
  {
    "indexPrice": "34400.15945055",
    "contractType": "PERPETUAL",
    "basisRate": "0.0004",
    "futuresPrice": "34414.10",
    "annualizedBasisRate": "",
    "basis": "13.94054945",
    "pair": "BTCUSDT",
    "timestamp": 1698742800000
  }
]

application/json

Check Server Time

Test connectivity to the Rest API and get the current server time.

GET

/fapi/v1/time

https://fapi.binance.com

Check Server Time › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Check Server Time › Responses

200

Check Server Time

serverTime

integer · int64

Server Time.

Example: 1499827319559

Composite Index Symbol Information

Query composite index symbol information

GET

/fapi/v1/indexInfo

https://fapi.binance.com

Composite Index Symbol Information › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Composite Index Symbol Information › Query Parameters

symbol

string

Example: DEFIUSDT

Composite Index Symbol Information › Responses

200

Composite Index Symbol Information

object

symbol

string

Example: DEFIUSDT

time

integer · int64

Current time

Example: 1589437530011

component

string

Component asset

Example: baseAsset

object[]

Example: []

baseAsset

string

Base Asset.

Example: BAL

quoteAsset

string

Quote Asset.

Example: USDT

weightInQuantity

string

Weight In Quantity.

Example: 1.04406228

weightInPercentage

string

Weight In Percentage.

Example: 0.02783900

GET/fapi/v1/indexInfo

curl --request GET \
  --url https://fapi.binance.com/fapi/v1/indexInfo

Example Responses

[
  {
    "symbol": "DEFIUSDT",
    "time": 1589437530011,
    "component": "baseAsset",
    "baseAssetList": []
  }
]

application/json

Compressed/Aggregate Trades List

Get compressed, aggregate market trades. Market trades that fill in 100ms with the same price and the same taking side will have the quantity aggregated.

Retail Price Improvement(RPI) orders are aggregated and without special tags to be distinguished.

GET

/fapi/v1/aggTrades

https://fapi.binance.com

Compressed/Aggregate Trades List › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight20

Compressed/Aggregate Trades List › Query Parameters

symbol

string · required

Symbol

Example: BTCUSDT

fromId

integer · int64

ID to get aggregate trades from INCLUSIVE.

Example: 1

startTime

integer · int64

Timestamp in ms to get aggregate trades from INCLUSIVE.

Example: 1623319461670

endTime

integer · int64

Timestamp in ms to get aggregate trades until INCLUSIVE.

Example: 1641782889000

limit

integer · int64 · max: 1000

Example: 50

Default: 500

Compressed/Aggregate Trades List › Responses

200

Compressed/Aggregate Trades List

object

a

integer · int64

Aggregate tradeId

Example: 26129

p

string

Price

Example: 0.01633102

q

string

Quantity

Example: 4.70443515

nq

string

Normal quantity without the trades involving RPI orders

Example: 100

f

integer · int64

First tradeId

Example: 27781

l

integer · int64

Last tradeId

Example: 27781

T

integer · int64

Timestamp

Example: 1498793709153

m

boolean

Was the buyer the maker?

Example: true

GET/fapi/v1/aggTrades

curl --request GET \
  --url 'https://fapi.binance.com/fapi/v1/aggTrades?symbol=%3Cstring%3E'

Example Responses

[
  {
    "a": 26129,
    "p": "0.01633102",
    "q": "4.70443515",
    "nq": "100",
    "f": 27781,
    "l": 27781,
    "T": 1498793709153,
    "m": true
  }
]

application/json

Continuous Contract Kline/Candlestick Data

Kline/candlestick bars for a specific contract type. Klines are uniquely identified by their open time.

GET

/fapi/v1/continuousKlines

https://fapi.binance.com

Continuous Contract Kline/Candlestick Data › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

based on parameter LIMIT

LIMIT	weight
[1,100)	1
[100, 500)	2
[500, 1000]	5
> 1000	10

Continuous Contract Kline/Candlestick Data › Query Parameters

pair

string · required

After CM migration, accepts both UM and CM pair values.

Example: BTCUSDT

contractType

string · enum · required

Futurestype

Enum values:

PERPETUAL

CURRENT_QUARTER

NEXT_QUARTER

TRADIFI_PERPETUAL

Example: PERPETUAL

interval

string · enum · required

Enum values:

15m

30m

Example: 1m

startTime

integer · int64

Start time

Example: 1623319461670

endTime

integer · int64

End time

Example: 1641782889000

limit

integer · int64 · max: 1500

Example: 50

Default: 500

Continuous Contract Kline/Candlestick Data › Responses

200

Continuous Contract Kline/Candlestick Data

array[]

tuple[12] · minItems: 12 · maxItems: 12

[0]

integer · int64 · required

Open time

Example: 1607444700000

[1]

string · required

Open

Example: 18879.99

[2]

string · required

High

Example: 18900.00

[3]

string · required

Low

Example: 18878.98

[4]

string · required

Example: 18896.13

[5]

string · required

Volume

Example: 492.363

[6]

integer · int64 · required

Close time

Example: 1607444759999

[7]

string · required

Quote asset volume

Example: 9302145.66080

[8]

integer · required

Number of trades

Example: 1874

[9]

string · required

Taker buy base asset volume

Example: 385.983

[10]

string · required

Taker buy quote asset volume

Example: 7292402.33267

[11]

string · required

Ignore

Example: 0

GET/fapi/v1/continuousKlines

curl --request GET \
  --url 'https://fapi.binance.com/fapi/v1/continuousKlines?pair=%3Cstring%3E&contractType=%3Cstring%3E&interval=%3Cstring%3E'

Example Responses

[
  [
    1607444700000,
    "18879.99",
    "18900.00",
    "18878.98",
    "18896.13",
    "492.363",
    1607444759999,
    "9302145.66080",
    1874,
    "385.983",
    "7292402.33267",
    "0"
  ]
]

application/json

Exchange Information

Current exchange trading rules and symbol information

GET

/fapi/v1/exchangeInfo

https://fapi.binance.com

Exchange Information › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Exchange Information › Responses

200

Exchange Information

exchangeFilters

string[]

object[]

Rate Limits.

API

interval

string

Interval.

Example: MINUTE

intervalNum

integer · int64

Interval Num.

Example: 1

limit

integer · int64

Limit.

Example: 2400

rateLimitType

string

Rate Limit Type.

Example: REQUEST_WEIGHT

serverTime

integer · int64

Ignore please. If you want to check current server time, please check via "GET /fapi/v1/time"

Example: 1565613908500

object[]

assets information

asset

string

Example: BTC

marginAvailable

boolean

whether the asset can be used as margin in Multi-Assets mode

Example: true

autoAssetExchange

string

auto-exchange threshold in Multi-Assets margin mode

Example: -0.10

object[]

Symbols.

symbols.

symbol

string

Symbol.

Example: BLZUSDT

pair

string

Pair.

Example: BLZUSDT

contractType

string

Contract Type.

Example: PERPETUAL

deliveryDate

integer · int64

Delivery Date.

Example: 4133404800000

onboardDate

integer · int64

Onboard Date.

Example: 1598252400000

status

string

Status.

Example: TRADING

maintMarginPercent

string

ignore

Example: 2.5000

requiredMarginPercent

string

ignore

Example: 5.0000

baseAsset

string

Base Asset.

Example: BLZ

quoteAsset

string

Quote Asset.

Example: USDT

marginAsset

string

Margin Asset.

Example: USDT

pricePrecision

integer · int64

please do not use it as tickSize

Example: 5

quantityPrecision

integer · int64

please do not use it as stepSize

Example: 0

baseAssetPrecision

integer · int64

Base Asset Precision.

Example: 8

quotePrecision

integer · int64

Quote Precision.

Example: 8

underlyingType

string

Example: COIN

underlyingSubType

string[]

settlePlan

integer · int64

Example: 0

triggerProtect

string

threshold for algo order with "priceProtect"

Example: 0.15

object[]

filterType

string

Filter Type.

Example: PRICE_FILTER

maxPrice

string

Max Price.

Example: 300

minPrice

string

Min Price.

Example: 0.0001

tickSize

string

Tick Size.

Example: 0.0001

maxQty

string

Max Qty.

Example: 10000000

minQty

string

Min Qty.

Example: 1

stepSize

string

Step Size.

Example: 1

limit

integer · int64

Limit.

Example: 200

notional

string

Example: 5.0

multiplierUp

string

Multiplier Up.

Example: 1.1500

multiplierDown

string

Multiplier Down.

Example: 0.8500

multiplierDecimal

string

Example: 4

orderTypes

string[]

timeInForce

string[]

Time In Force.

liquidationFee

string

liquidation fee rate

Example: 0.010000

marketTakeBound

string

the max price difference rate( from mark price) a market order can make

Example: 0.30

timezone

string

Timezone.

Example: UTC

GET/fapi/v1/exchangeInfo

curl --request GET \
  --url https://fapi.binance.com/fapi/v1/exchangeInfo

Example Responses

{
  "exchangeFilters": [
    ""
  ],
  "rateLimits": [
    {
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 2400,
      "rateLimitType": "REQUEST_WEIGHT"
    }
  ],
  "serverTime": 1565613908500,
  "assets": [
    {
      "asset": "BTC",
      "marginAvailable": true,
      "autoAssetExchange": "-0.10"
    }
  ],
  "symbols": [
    {
      "symbol": "BLZUSDT",
      "pair": "BLZUSDT",
      "contractType": "PERPETUAL",
      "deliveryDate": 4133404800000,
      "onboardDate": 1598252400000,
      "status": "TRADING",
      "maintMarginPercent": "2.5000",
      "requiredMarginPercent": "5.0000",
      "baseAsset": "BLZ",
      "quoteAsset": "USDT",
      "marginAsset": "USDT",
      "pricePrecision": 5,
      "quantityPrecision": 0,
      "baseAssetPrecision": 8,
      "quotePrecision": 8,
      "underlyingType": "COIN",
      "underlyingSubType": [
        "STORAGE"
      ],
      "settlePlan": 0,
      "triggerProtect": "0.15",
      "filters": [
        {
          "filterType": "PRICE_FILTER",
          "maxPrice": "300",
          "minPrice": "0.0001",
          "tickSize": "0.0001",
          "maxQty": "10000000",
          "minQty": "1",
          "stepSize": "1",
          "limit": 200,
          "notional": "5.0",
          "multiplierUp": "1.1500",
          "multiplierDown": "0.8500",
          "multiplierDecimal": "4"
        }
      ],
      "orderTypes": [
        "LIMIT"
      ],
      "timeInForce": [
        "GTC"
      ],
      "liquidationFee": "0.010000",
      "marketTakeBound": "0.30"
    }
  ],
  "timezone": "UTC"
}

application/json

Get Funding Rate History

GET

/fapi/v1/fundingRate

https://fapi.binance.com

Get Funding Rate History › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

share 500/5min/IP rate limit with GET /fapi/v1/fundingInfo

Get Funding Rate History › Query Parameters

symbol

string

Example: BTCUSDT

startTime

integer · int64

Timestamp in ms to get funding rate from INCLUSIVE.

Example: 1623319461670

endTime

integer · int64

Timestamp in ms to get funding rate until INCLUSIVE.

Example: 1641782889000

limit

integer · int64 · max: 1000

Example: 50

Default: 100

Get Funding Rate History › Responses

200

Get Funding Rate History

object

symbol

string

Symbol.

Example: BTCUSDT

fundingRate

string

Funding Rate.

Example: -0.03750000

fundingTime

integer · int64

Funding Time.

Example: 1570608000000

markPrice

string

mark price associated with a particular funding fee charge

Example: 34287.54619963

GET/fapi/v1/fundingRate

curl --request GET \
  --url https://fapi.binance.com/fapi/v1/fundingRate

Example Responses

[
  {
    "symbol": "BTCUSDT",
    "fundingRate": "-0.03750000",
    "fundingTime": 1570608000000,
    "markPrice": "34287.54619963"
  }
]

application/json

Get Funding Rate Info

Query funding rate info for symbols that had FundingRateCap/FundingRateFloor / fundingIntervalHours adjustment

GET

/fapi/v1/fundingInfo

https://fapi.binance.com

Get Funding Rate Info › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

share 500/5min/IP rate limit with GET /fapi/v1/fundingRate

Get Funding Rate Info › Responses

200

Get Funding Rate Info

object

symbol

string

Example: BLZUSDT

adjustedFundingRateCap

string

Example: 0.02500000

adjustedFundingRateFloor

string

Example: -0.02500000

fundingIntervalHours

integer · int64

Example: 8

disclaimer

boolean

ingore

Example: false

GET/fapi/v1/fundingInfo

curl --request GET \
  --url https://fapi.binance.com/fapi/v1/fundingInfo

Example Responses

[
  {
    "symbol": "BLZUSDT",
    "adjustedFundingRateCap": "0.02500000",
    "adjustedFundingRateFloor": "-0.02500000",
    "fundingIntervalHours": 8,
    "disclaimer": false
  }
]

application/json

Index Price Kline/Candlestick Data

Kline/candlestick bars for the index price of a pair. Klines are uniquely identified by their open time.

GET

/fapi/v1/indexPriceKlines

https://fapi.binance.com

Index Price Kline/Candlestick Data › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

based on parameter LIMIT

LIMIT	weight
[1,100)	1
[100, 500)	2
[500, 1000]	5
> 1000	10

Index Price Kline/Candlestick Data › Query Parameters

pair

string · required

After CM migration, accepts both UM and CM pair values.

Example: BTCUSDT

interval

string · enum · required

Enum values:

15m

30m

Example: 1m

startTime

integer · int64

Start time

Example: 1623319461670

endTime

integer · int64

End time

Example: 1641782889000

limit

integer · int64 · max: 1500

Example: 50

Default: 500

Index Price Kline/Candlestick Data › Responses

200

Index Price Kline/Candlestick Data

array[]

tuple[12] · minItems: 12 · maxItems: 12

[0]

integer · int64 · required

Open time

Example: 1591256400000

[1]

string · required

Open

Example: 9653.69440000

[2]

string · required

High

Example: 9653.69640000

[3]

string · required

Low

Example: 9651.38600000

[4]

string · required

Example: 9651.55200000

[5]

string · required

Ignore

Example: 0

[6]

integer · int64 · required

Close time

Example: 1591256459999

[7]

string · required

Ignore

Example: 0

[8]

integer · required

Ignore

Example: 60

[9]

string · required

Ignore

Example: 0

[10]

string · required

Ignore

Example: 0

[11]

string · required

Ignore

Example: 0

GET/fapi/v1/indexPriceKlines

curl --request GET \
  --url 'https://fapi.binance.com/fapi/v1/indexPriceKlines?pair=%3Cstring%3E&interval=%3Cstring%3E'

Example Responses

[
  [
    1591256400000,
    "9653.69440000",
    "9653.69640000",
    "9651.38600000",
    "9651.55200000",
    "0",
    1591256459999,
    "0",
    60,
    "0",
    "0",
    "0"
  ]
]

application/json

Kline/Candlestick Data

Kline/candlestick bars for a symbol. Klines are uniquely identified by their open time.

GET

/fapi/v1/klines

https://fapi.binance.com

Kline/Candlestick Data › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

based on parameter LIMIT

LIMIT	weight
[1,100)	1
[100, 500)	2
[500, 1000]	5
> 1000	10

Kline/Candlestick Data › Query Parameters

symbol

string · required

After CM migration, accepts both UM and CM symbols.

Example: BTCUSDT

interval

string · enum · required

Enum values:

15m

30m

Example: 1m

startTime

integer · int64

Start time

Example: 1623319461670

endTime

integer · int64

End time

Example: 1641782889000

limit

integer · int64 · max: 1500

Example: 50

Default: 500

Kline/Candlestick Data › Responses

200

Kline/Candlestick Data

array[]

tuple[12] · minItems: 12 · maxItems: 12

[0]

integer · int64 · required

Open time

Example: 1499040000000

[1]

string · required

Open

Example: 0.01634790

[2]

string · required

High

Example: 0.80000000

[3]

string · required

Low

Example: 0.01575800

[4]

string · required

Example: 0.01577100

[5]

string · required

Volume

Example: 148976.11427815

[6]

integer · int64 · required

Close time

Example: 1499644799999

[7]

string · required

Quote asset volume

Example: 2434.19055334

[8]

integer · required

Number of trades

Example: 308

[9]

string · required

Taker buy base asset volume

Example: 1756.87402397

[10]

string · required

Taker buy quote asset volume

Example: 28.46694368

[11]

string · required

Ignore

Example: 17928899.62484339

GET/fapi/v1/klines

curl --request GET \
  --url 'https://fapi.binance.com/fapi/v1/klines?symbol=%3Cstring%3E&interval=%3Cstring%3E'

Example Responses

[
  [
    1499040000000,
    "0.01634790",
    "0.80000000",
    "0.01575800",
    "0.01577100",
    "148976.11427815",
    1499644799999,
    "2434.19055334",
    308,
    "1756.87402397",
    "28.46694368",
    "17928899.62484339"
  ]
]

application/json

Long/Short Ratio

Query symbol Long/Short Ratio

GET

/futures/data/globalLongShortAccountRatio

https://fapi.binance.com

Long/Short Ratio › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight0

Long/Short Ratio › Query Parameters

symbol

string · required

Example: BTCUSDT

period

string · enum · required

Enum values:

15m

30m

12h

Example: 5m

limit

integer · int64 · max: 500

Example: 50

Default: 30

startTime

integer · int64

Example: 1623319461670

endTime

integer · int64

Example: 1641782889000

Long/Short Ratio › Responses

200

Long/Short Ratio

object

symbol

string

long/short account num ratio of all traders

Example: BTCUSDT

longShortRatio

string

long account num ratio of all traders

Example: 0.1960

longAccount

string

short account num ratio of all traders

Example: 0.6622

shortAccount

string

Short Account.

Example: 0.3378

timestamp

integer · int64

Timestamp in milliseconds.

Example: 1591261042378

GET/futures/data/globalLongShortAccountRatio

curl --request GET \
  --url 'https://fapi.binance.com/futures/data/globalLongShortAccountRatio?symbol=%3Cstring%3E&period=%3Cstring%3E'

Example Responses

[
  {
    "symbol": "BTCUSDT",
    "longShortRatio": "0.1960",
    "longAccount": "0.6622",
    "shortAccount": "0.3378",
    "timestamp": 1591261042378
  }
]

application/json

Mark Price

Mark Price and Funding Rate

GET

/fapi/v1/premiumIndex

https://fapi.binance.com

Mark Price › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

1 with symbol, 10 without symbol

Mark Price › Query Parameters

symbol

string

Example: BTCUSDT

Mark Price › Responses

200

Mark Price

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = array

Properties for Variant 1:

symbol

string

Symbol.

Example: BTCUSDT

markPrice

string

mark price

Example: 11793.63104562

indexPrice

string

index price

Example: 11781.80495970

estimatedSettlePrice

string

Estimated Settle Price, only useful in the last hour before the settlement starts.

Example: 11781.16138815

lastFundingRate

string

This is the Latest funding rate

Example: 0.00038246

interestRate

string

Interest Rate.

Example: 0.00010000

nextFundingTime

integer · int64

Next Funding Time.

Example: 1597392000000

time

integer · int64

Time.

Example: 1597370495002

GET/fapi/v1/premiumIndex

curl --request GET \
  --url https://fapi.binance.com/fapi/v1/premiumIndex

Example Responses

{
  "symbol": "BTCUSDT",
  "markPrice": "11793.63104562",
  "indexPrice": "11781.80495970",
  "estimatedSettlePrice": "11781.16138815",
  "lastFundingRate": "0.00038246",
  "interestRate": "0.00010000",
  "nextFundingTime": 1597392000000,
  "time": 1597370495002
}

application/json

Mark Price Kline/Candlestick Data

Kline/candlestick bars for the mark price of a symbol. Klines are uniquely identified by their open time.

GET

/fapi/v1/markPriceKlines

https://fapi.binance.com

Mark Price Kline/Candlestick Data › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

based on parameter LIMIT

LIMIT	weight
[1,100)	1
[100, 500)	2
[500, 1000]	5
> 1000	10

Mark Price Kline/Candlestick Data › Query Parameters

symbol

string · required

After CM migration, accepts both UM and CM symbols.

Example: BTCUSDT

interval

string · enum · required

Enum values:

15m

30m

Example: 1m

startTime

integer · int64

Start time

Example: 1623319461670

endTime

integer · int64

End time

Example: 1641782889000

limit

integer · int64 · max: 1500

Example: 50

Default: 500

Mark Price Kline/Candlestick Data › Responses

200

Mark Price Kline/Candlestick Data

array[]

tuple[12] · minItems: 12 · maxItems: 12

[0]

integer · int64 · required

Open time

Example: 1591256460000

[1]

string · required

Open

Example: 9653.29201333

[2]

string · required

High

Example: 9654.56401333

[3]

string · required

Low

Example: 9653.07367333

[4]

string · required

Example: 9653.07367333

[5]

string · required

Ignore

Example: 0

[6]

integer · int64 · required

Close time

Example: 1591256519999

[7]

string · required

Ignore

Example: 0

[8]

integer · required

Ignore

Example: 60

[9]

string · required

Ignore

Example: 0

[10]

string · required

Ignore

Example: 0

[11]

string · required

Ignore

Example: 0

GET/fapi/v1/markPriceKlines

curl --request GET \
  --url 'https://fapi.binance.com/fapi/v1/markPriceKlines?symbol=%3Cstring%3E&interval=%3Cstring%3E'

Example Responses

[
  [
    1591256460000,
    "9653.29201333",
    "9654.56401333",
    "9653.07367333",
    "9653.07367333",
    "0",
    1591256519999,
    "0",
    60,
    "0",
    "0",
    "0"
  ]
]

application/json

Multi-Assets Mode Asset Index

Asset index price.

CM-UM Integration (Effective 2026-06-30): Renamed from Multi-Assets Mode Asset Index. The response now additionally pushes COIN-M settlement-asset price index entries (e.g., BTCUSD, ETHUSD, BNBUSD). The endpoint path /fapi/v1/assetIndex is unchanged.

GET

/fapi/v1/assetIndex

https://fapi.binance.com

Multi-Assets Mode Asset Index › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

1 for a single symbol; 10 when the symbol parameter is omitted

Multi-Assets Mode Asset Index › Query Parameters

symbol

string

Asset pair

Example: ADAUSD

Multi-Assets Mode Asset Index › Responses

200

Multi-Assets Mode Asset Index

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = array

Properties for Variant 1:

symbol

string

Example: ADAUSD

time

integer · int64

Example: 1635740268004

index

string

Example: 1.92957370

bidBuffer

string

Example: 0.10000000

askBuffer

string

Example: 0.10000000

bidRate

string

Example: 1.73661633

askRate

string

Example: 2.12253107

autoExchangeBidBuffer

string

Example: 0.05000000

autoExchangeAskBuffer

string

Example: 0.05000000

autoExchangeBidRate

string

Example: 1.83309501

autoExchangeAskRate

string

Example: 2.02605238

GET/fapi/v1/assetIndex

curl --request GET \
  --url https://fapi.binance.com/fapi/v1/assetIndex

Example Responses

{
  "symbol": "ADAUSD",
  "time": 1635740268004,
  "index": "1.92957370",
  "bidBuffer": "0.10000000",
  "askBuffer": "0.10000000",
  "bidRate": "1.73661633",
  "askRate": "2.12253107",
  "autoExchangeBidBuffer": "0.05000000",
  "autoExchangeAskBuffer": "0.05000000",
  "autoExchangeBidRate": "1.83309501",
  "autoExchangeAskRate": "2.02605238"
}

application/json

Old Trades Lookup (MARKET_DATA)

Get older market historical trades.

GET

/fapi/v1/historicalTrades

https://fapi.binance.com

Old Trades Lookup (MARKET_DATA) › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight20

Old Trades Lookup (MARKET_DATA) › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Old Trades Lookup (MARKET_DATA) › Query Parameters

symbol

string · required

Example: BTCUSDT

limit

integer · int64 · max: 500

Example: 50

Default: 100

fromId

integer · int64

TradeId to fetch from. Default gets most recent trades.

Example: 1

Old Trades Lookup (MARKET_DATA) › Responses

200

Old Trades Lookup

object

id

integer · int64

Id.

Example: 28457

price

string

Price.

Example: 4.00000100

qty

string

Qty.

Example: 12.00000000

quoteQty

string

Quote Qty.

Example: 8000.00

time

integer · int64

Time.

Example: 1499865549590

isBuyerMaker

boolean

Is Buyer Maker.

Example: true

isRPITrade

boolean

Is RPITrade.

Example: true

GET/fapi/v1/historicalTrades

curl --request GET \
  --url 'https://fapi.binance.com/fapi/v1/historicalTrades?symbol=%3Cstring%3E' \
  --header 'X-MBX-APIKEY: <string>'

Example Responses

[
  {
    "id": 28457,
    "price": "4.00000100",
    "qty": "12.00000000",
    "quoteQty": "8000.00",
    "time": 1499865549590,
    "isBuyerMaker": true,
    "isRPITrade": true
  }
]

application/json

Open Interest

Get present open interest of a specific symbol.

GET

/fapi/v1/openInterest

https://fapi.binance.com

Open Interest › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Open Interest › Query Parameters

symbol

string · required

Example: BTCUSDT

Open Interest › Responses

200

Open Interest

openInterest

string

Open Interest.

Example: 10659.509

symbol

string

Symbol.

Example: BTCUSDT

time

integer · int64

Transaction time

Example: 1589437530011

GET/fapi/v1/openInterest

curl --request GET \
  --url 'https://fapi.binance.com/fapi/v1/openInterest?symbol=%3Cstring%3E'

Example Responses

{
  "openInterest": "10659.509",
  "symbol": "BTCUSDT",
  "time": 1589437530011
}

application/json

Open Interest Statistics

GET

/futures/data/openInterestHist

https://fapi.binance.com

Open Interest Statistics › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight0

Open Interest Statistics › Query Parameters

symbol

string · required

Example: BTCUSDT

period

string · enum · required

Enum values:

15m

30m

12h

Example: 5m

limit

integer · int64 · max: 500

Example: 50

Default: 30

startTime

integer · int64

Example: 1623319461670

endTime

integer · int64

Example: 1641782889000

Open Interest Statistics › Responses

200

Open Interest Statistics

object

symbol

string

Example: BTCUSDT

sumOpenInterest

string

total open interest

Example: 20403.12345678

sumOpenInterestValue

string

total open interest value

Example: 176196512.12345678

CMCCirculatingSupply

string

circulating supply provided by CMC

Example: 165880.538

timestamp

integer · int64

Timestamp in milliseconds.

Example: 1591261042378

GET/futures/data/openInterestHist

curl --request GET \
  --url 'https://fapi.binance.com/futures/data/openInterestHist?symbol=%3Cstring%3E&period=%3Cstring%3E'

Example Responses

[
  {
    "symbol": "BTCUSDT",
    "sumOpenInterest": "20403.12345678",
    "sumOpenInterestValue": "176196512.12345678",
    "CMCCirculatingSupply": "165880.538",
    "timestamp": 1591261042378
  }
]

application/json

Order Book

Query symbol orderbook

Retail Price Improvement(RPI) orders are not visible and excluded in the response message.

GET

/fapi/v1/depth

https://fapi.binance.com

Order Book › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

Adjusted based on the limit:

Limit	Weight
5, 10, 20, 50	2
100	5
500	10
1000	20

Order Book › Query Parameters

symbol

string · required

Example: BTCUSDT

limit

integer · int64 · max: 1000

Valid limits:[5, 10, 20, 50, 100, 500, 1000]

Example: 50

Default: 500

Order Book › Responses

200

Order Book

lastUpdateId

integer · int64

Example: 1027024

E

integer · int64

Message output time

Example: 1589436922972

T

integer · int64

Transaction time

Example: 1589436922959

array[]

Bid orders. Each entry is [price, quantity].

Example: [["4.00000000","431.00000000"]]

tuple[2] · minItems: 2 · maxItems: 2

[0]

string · required

Price

Example: 4.00000000

[1]

string · required

Quantity

Example: 431.00000000

array[]

Ask orders. Each entry is [price, quantity].

Example: [["4.00000200","12.00000000"]]

tuple[2] · minItems: 2 · maxItems: 2

[0]

string · required

Price

Example: 4.00000200

[1]

string · required

Quantity

Example: 12.00000000

GET/fapi/v1/depth

curl --request GET \
  --url 'https://fapi.binance.com/fapi/v1/depth?symbol=%3Cstring%3E'

Example Responses

{
  "lastUpdateId": 1027024,
  "E": 1589436922972,
  "T": 1589436922959,
  "bids": [
    [
      "4.00000000",
      "431.00000000"
    ]
  ],
  "asks": [
    [
      "4.00000200",
      "12.00000000"
    ]
  ]
}

application/json

Premium index Kline Data

Premium index kline bars of a symbol. Klines are uniquely identified by their open time.

GET

/fapi/v1/premiumIndexKlines

https://fapi.binance.com

Premium index Kline Data › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

based on parameter LIMIT

LIMIT	weight
[1,100)	1
[100, 500)	2
[500, 1000]	5
> 1000	10

Premium index Kline Data › Query Parameters

symbol

string · required

After CM migration, accepts both UM and CM symbols.

Example: BTCUSDT

interval

string · enum · required

Enum values:

15m

30m

Example: 1m

startTime

integer · int64

Start time

Example: 1623319461670

endTime

integer · int64

End time

Example: 1641782889000

limit

integer · int64 · max: 1500

Example: 50

Default: 500

Premium index Kline Data › Responses

200

Premium index Kline Data

array[]

tuple[12] · minItems: 12 · maxItems: 12

[0]

integer · int64 · required

Open time

Example: 1691603820000

[1]

string · required

Open

Example: -0.00042931

[2]

string · required

High

Example: -0.00023641

[3]

string · required

Low

Example: -0.00059406

[4]

string · required

Example: -0.00043659

[5]

string · required

Ignore

Example: 0

[6]

integer · int64 · required

Close time

Example: 1691603879999

[7]

string · required

Ignore

Example: 0

[8]

integer · required

Ignore

Example: 12

[9]

string · required

Ignore

Example: 0

[10]

string · required

Ignore

Example: 0

[11]

string · required

Ignore

Example: 0

GET/fapi/v1/premiumIndexKlines

curl --request GET \
  --url 'https://fapi.binance.com/fapi/v1/premiumIndexKlines?symbol=%3Cstring%3E&interval=%3Cstring%3E'

Example Responses

[
  [
    1691603820000,
    "-0.00042931",
    "-0.00023641",
    "-0.00059406",
    "-0.00043659",
    "0",
    1691603879999,
    "0",
    12,
    "0",
    "0",
    "0"
  ]
]

application/json

Quarterly Contract Settlement Price

Latest price for a symbol or symbols.

GET

/futures/data/delivery-price

https://fapi.binance.com

Quarterly Contract Settlement Price › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight0

Quarterly Contract Settlement Price › Query Parameters

pair

string · required

Example: BTCUSDT

Quarterly Contract Settlement Price › Responses

200

Quarterly Contract Settlement Price

object

deliveryTime

integer · int64

Example: 1695945600000

deliveryPrice

number · float

Example: 27103

GET/futures/data/delivery-price

curl --request GET \
  --url 'https://fapi.binance.com/futures/data/delivery-price?pair=%3Cstring%3E'

Example Responses

[
  {
    "deliveryTime": 1695945600000,
    "deliveryPrice": 27103
  }
]

application/json

Query Index Price Constituents

Query index price constituents

Note: Prices from constituents of TradFi perps will be hiden and displayed as -1.

GET

/fapi/v1/constituents

https://fapi.binance.com

Query Index Price Constituents › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight2

Query Index Price Constituents › Query Parameters

symbol

string · required

Example: BTCUSDT

Query Index Price Constituents › Responses

200

Index Price Constituents

symbol

string

Example: BTCUSDT

time

integer · int64

Example: 1745401553408

object[]

Example: []

exchange

string

Example: binance

symbol

string

Example: BTCUSDT

price

string

Example: 94057.03000000

weight

string

Example: 0.51282051

GET/fapi/v1/constituents

curl --request GET \
  --url 'https://fapi.binance.com/fapi/v1/constituents?symbol=%3Cstring%3E'

Example Responses

{
  "symbol": "BTCUSDT",
  "time": 1745401553408,
  "constituents": []
}

application/json

Query Insurance Fund Balance Snapshot

GET

/fapi/v1/insuranceBalance

https://fapi.binance.com

Query Insurance Fund Balance Snapshot › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Query Insurance Fund Balance Snapshot › Query Parameters

symbol

string

Symbol

Example: BNBUSDT

Query Insurance Fund Balance Snapshot › Responses

200

Insurance Fund Balance Snapshot

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = array

Properties for Variant 1:

symbols

string[]

Example: []

object[]

Example: []

Recent Trades List

Get recent market trades

GET

/fapi/v1/trades

https://fapi.binance.com

Recent Trades List › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight5

Recent Trades List › Query Parameters

symbol

string · required

Example: BTCUSDT

limit

integer · int64 · max: 1000

Example: 50

Default: 500

Recent Trades List › Responses

200

Recent Trades List

object

id

integer · int64

Id.

Example: 28457

price

string

Price.

Example: 4.00000100

qty

string

Qty.

Example: 12.00000000

quoteQty

string

Quote Qty.

Example: 48.00

time

integer · int64

Time.

Example: 1499865549590

isBuyerMaker

boolean

Is Buyer Maker.

Example: true

isRPITrade

boolean

Is RPITrade.

Example: true

GET/fapi/v1/trades

curl --request GET \
  --url 'https://fapi.binance.com/fapi/v1/trades?symbol=%3Cstring%3E'

Example Responses

[
  {
    "id": 28457,
    "price": "4.00000100",
    "qty": "12.00000000",
    "quoteQty": "48.00",
    "time": 1499865549590,
    "isBuyerMaker": true,
    "isRPITrade": true
  }
]

application/json

RPI Order Book

Query symbol orderbook with RPI orders

RPI(Retail Price Improvement) orders are included and aggreated in the response message. Crossed price levels are hidden and invisible.

GET

/fapi/v1/rpiDepth

https://fapi.binance.com

RPI Order Book › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

Adjusted based on the limit:

Limit	Weight
1000	20

RPI Order Book › Query Parameters

symbol

string · required

Example: BTCUSDT

limit

integer · int64

Valid limits:[1000]

Example: 1000

Default: 1000

RPI Order Book › Responses

200

RPI Order Book

lastUpdateId

integer · int64

Example: 1027024

E

integer · int64

Message output time

Example: 1589436922972

T

integer · int64

Transaction time

Example: 1589436922959

array[]

Bid orders. Each entry is [price, quantity].

Example: [["4.00000000","431.00000000"]]

tuple[2] · minItems: 2 · maxItems: 2

[0]

string · required

Price

Example: 4.00000000

[1]

string · required

Quantity

Example: 431.00000000

array[]

Ask orders. Each entry is [price, quantity].

Example: [["4.00000200","12.00000000"]]

tuple[2] · minItems: 2 · maxItems: 2

[0]

string · required

Price

Example: 4.00000200

[1]

string · required

Quantity

Example: 12.00000000

GET/fapi/v1/rpiDepth

curl --request GET \
  --url 'https://fapi.binance.com/fapi/v1/rpiDepth?symbol=%3Cstring%3E'

Example Responses

{
  "lastUpdateId": 1027024,
  "E": 1589436922972,
  "T": 1589436922959,
  "bids": [
    [
      "4.00000000",
      "431.00000000"
    ]
  ],
  "asks": [
    [
      "4.00000200",
      "12.00000000"
    ]
  ]
}

application/json

Symbol Order Book Ticker

Best price/qty on the order book for a symbol or symbols.

Retail Price Improvement(RPI) orders are not visible and excluded in the response message.

GET

/fapi/v1/ticker/bookTicker

https://fapi.binance.com

Symbol Order Book Ticker › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

2 for a single symbol; 5 when the symbol parameter is omitted

Symbol Order Book Ticker › Query Parameters

symbol

string

Example: BTCUSDT

Symbol Order Book Ticker › Responses

200

Symbol Order Book Ticker

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = array

Properties for Variant 1:

symbol

string

Symbol.

Example: BTCUSDT

bidPrice

string

Bid Price.

Example: 4.00000000

bidQty

string

Bid Qty.

Example: 431.00000000

askPrice

string

Ask Price.

Example: 4.00000200

askQty

string

Ask Qty.

Example: 9.00000000

time

integer · int64

Transaction time

Example: 1589437530011

GET/fapi/v1/ticker/bookTicker

curl --request GET \
  --url https://fapi.binance.com/fapi/v1/ticker/bookTicker

Example Responses

{
  "symbol": "BTCUSDT",
  "bidPrice": "4.00000000",
  "bidQty": "431.00000000",
  "askPrice": "4.00000200",
  "askQty": "9.00000000",
  "time": 1589437530011
}

application/json

deprecated

Symbol Price Ticker

Latest price for a symbol or symbols.

GET

/fapi/v1/ticker/price

https://fapi.binance.com

Symbol Price Ticker › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

1 for a single symbol; 2 when the symbol parameter is omitted

Symbol Price Ticker › Query Parameters

symbol

string

Example: BTCUSDT

Symbol Price Ticker › Responses

200

Symbol Price Ticker

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = array

Properties for Variant 1:

symbol

string

Symbol.

Example: BTCUSDT

price

string

Price.

Example: 6000.01

time

integer · int64

Transaction time

Example: 1589437530011

GET/fapi/v1/ticker/price

curl --request GET \
  --url https://fapi.binance.com/fapi/v1/ticker/price

Example Responses

{
  "symbol": "BTCUSDT",
  "price": "6000.01",
  "time": 1589437530011
}

application/json

Symbol Price Ticker V2

Latest price for a symbol or symbols.

GET

/fapi/v2/ticker/price

https://fapi.binance.com

Symbol Price Ticker V2 › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

1 for a single symbol; 2 when the symbol parameter is omitted

Symbol Price Ticker V2 › Query Parameters

symbol

string

Example: BTCUSDT

Symbol Price Ticker V2 › Responses

200

Symbol Price Ticker V2

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = array

Properties for Variant 1:

symbol

string

Symbol.

Example: BTCUSDT

price

string

Price.

Example: 6000.01

time

integer · int64

Transaction time

Example: 1589437530011

GET/fapi/v2/ticker/price

curl --request GET \
  --url https://fapi.binance.com/fapi/v2/ticker/price

Example Responses

{
  "symbol": "BTCUSDT",
  "price": "6000.01",
  "time": 1589437530011
}

application/json

Taker Buy/Sell Volume

GET

/futures/data/takerlongshortRatio

https://fapi.binance.com

Taker Buy/Sell Volume › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight0

Taker Buy/Sell Volume › Query Parameters

symbol

string · required

Example: BTCUSDT

period

string · enum · required

Enum values:

15m

30m

12h

Example: 5m

limit

integer · int64 · max: 500

Example: 50

Default: 30

startTime

integer · int64

Example: 1623319461670

endTime

integer · int64

Example: 1641782889000

Taker Buy/Sell Volume › Responses

200

Taker Buy/Sell Volume

object

buySellRatio

string

Example: 1.5586

buyVol

string

Example: 387.3300

sellVol

string

Example: 248.5030

timestamp

integer · int64

Timestamp in milliseconds.

Example: 1591261042378

GET/futures/data/takerlongshortRatio

curl --request GET \
  --url 'https://fapi.binance.com/futures/data/takerlongshortRatio?symbol=%3Cstring%3E&period=%3Cstring%3E'

Example Responses

[
  {
    "buySellRatio": "1.5586",
    "buyVol": "387.3300",
    "sellVol": "248.5030",
    "timestamp": 1591261042378
  }
]

application/json

Test Connectivity

Test connectivity to the Rest API.

GET

/fapi/v1/ping

https://fapi.binance.com

Test Connectivity › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Test Connectivity › Responses

200

No data returned

24hr Ticker Price Change Statistics

24 hour rolling window price change statistics. Careful when accessing this with no symbol.

GET

/fapi/v1/ticker/24hr

https://fapi.binance.com

24hr Ticker Price Change Statistics › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

1 for a single symbol; 40 when the symbol parameter is omitted

24hr Ticker Price Change Statistics › Query Parameters

symbol

string

Example: BTCUSDT

24hr Ticker Price Change Statistics › Responses

200

24hr Ticker Price Change Statistics

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = array

Properties for Variant 1:

symbol

string

Example: BTCUSDT

priceChange

string

Price Change.

Example: -94.99999800

priceChangePercent

string

Price Change Percent.

Example: -95.960

weightedAvgPrice

string

Weighted Avg Price.

Example: 0.29628482

lastPrice

string

Last Price.

Example: 4.00000200

lastQty

string

Last Qty.

Example: 200.00000000

openPrice

string

Open Price.

Example: 99.00000000

highPrice

string

High Price.

Example: 100.00000000

lowPrice

string

Low Price.

Example: 0.10000000

volume

string

Volume.

Example: 8913.30000000

quoteVolume

string

Quote Volume.

Example: 15.30000000

openTime

integer · int64

Open Time.

Example: 1499783499040

closeTime

integer · int64

Close Time.

Example: 1499869899040

firstId

integer · int64

First tradeId

Example: 28385

lastId

integer · int64

Last tradeId

Example: 28460

count

integer · int64

Trade count

Example: 76

GET/fapi/v1/ticker/24hr

curl --request GET \
  --url https://fapi.binance.com/fapi/v1/ticker/24hr

Example Responses

{
  "symbol": "BTCUSDT",
  "priceChange": "-94.99999800",
  "priceChangePercent": "-95.960",
  "weightedAvgPrice": "0.29628482",
  "lastPrice": "4.00000200",
  "lastQty": "200.00000000",
  "openPrice": "99.00000000",
  "highPrice": "100.00000000",
  "lowPrice": "0.10000000",
  "volume": "8913.30000000",
  "quoteVolume": "15.30000000",
  "openTime": 1499783499040,
  "closeTime": 1499869899040,
  "firstId": 28385,
  "lastId": 28460,
  "count": 76
}

application/json

Top Trader Long/Short Account Ratio (MARKET_DATA)

The proportion of net long and net short accounts to total accounts of the top 20% users with the highest margin balance. Each account is counted once only.

Long Account % = Accounts of top traders with net long positions / Total accounts of top traders with open positions

Short Account % = Accounts of top traders with net short positions / Total accounts of top traders with open positions

Long/Short Ratio (Accounts) = Long Account % / Short Account %

GET

/futures/data/topLongShortAccountRatio

https://fapi.binance.com

Top Trader Long/Short Account Ratio (MARKET_DATA) › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Top Trader Long/Short Account Ratio (MARKET_DATA) › Query Parameters

symbol

string · required

Example: BTCUSDT

period

string · enum · required

Enum values:

15m

30m

12h

Example: 5m

limit

integer · int64 · max: 500

Example: 50

Default: 30

startTime

integer · int64

Example: 1623319461670

endTime

integer · int64

Example: 1641782889000

Top Trader Long/Short Account Ratio (MARKET_DATA) › Responses

200

Top Trader Long/Short Ratio

object

symbol

string

Example: BTCUSDT

longShortRatio

string

long/short account num ratio of top traders

Example: 1.8105

longAccount

string

long account num ratio of top traders

Example: 0.6442

shortAccount

string

long account num ratio of top traders

Example: 0.3558

timestamp

integer · int64

Timestamp in milliseconds.

Example: 1591261042378

GET/futures/data/topLongShortAccountRatio

curl --request GET \
  --url 'https://fapi.binance.com/futures/data/topLongShortAccountRatio?symbol=%3Cstring%3E&period=%3Cstring%3E' \
  --header 'X-MBX-APIKEY: <string>'

Example Responses

[
  {
    "symbol": "BTCUSDT",
    "longShortRatio": "1.8105",
    "longAccount": "0.6442",
    "shortAccount": "0.3558",
    "timestamp": 1591261042378
  }
]

application/json

Top Trader Long/Short Position Ratio (MARKET_DATA)

The proportion of net long and net short positions to total open positions of the top 20% users with the highest margin balance.

Long Position % = Long positions of top traders / Total open positions of top traders

Short Position % = Short positions of top traders / Total open positions of top traders

Long/Short Ratio (Positions) = Long Position % / Short Position %

GET

/futures/data/topLongShortPositionRatio

https://fapi.binance.com

Top Trader Long/Short Position Ratio (MARKET_DATA) › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight0

Top Trader Long/Short Position Ratio (MARKET_DATA) › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Top Trader Long/Short Position Ratio (MARKET_DATA) › Query Parameters

symbol

string · required

Example: BTCUSDT

period

string · enum · required

Enum values:

15m

30m

12h

Example: 5m

limit

integer · int64 · max: 500

Example: 50

Default: 30

startTime

integer · int64

Example: 1623319461670

endTime

integer · int64

Example: 1641782889000

Top Trader Long/Short Position Ratio (MARKET_DATA) › Responses

200

Top Trader Long/Short Ratio

object

symbol

string

Example: BTCUSDT

longShortRatio

string

long/short position ratio of top traders

Example: 1.4342

longAccount

string

long positions ratio of top traders

Example: 0.5344

shortAccount

string

short positions ratio of top traders

Example: 0.4238

timestamp

integer · int64

Timestamp in milliseconds.

Example: 1591261042378

GET/futures/data/topLongShortPositionRatio

curl --request GET \
  --url 'https://fapi.binance.com/futures/data/topLongShortPositionRatio?symbol=%3Cstring%3E&period=%3Cstring%3E' \
  --header 'X-MBX-APIKEY: <string>'

Example Responses

[
  {
    "symbol": "BTCUSDT",
    "longShortRatio": "1.4342",
    "longAccount": "0.5344",
    "shortAccount": "0.4238",
    "timestamp": 1591261042378
  }
]

application/json

Trading Schedule

Trading session schedules for the underlying assets of TradFi Perps are provided for a one-week period forward and one-week period backward starting from the day prior to the query time, covering the U.S. equity market, Korean equity market, Hong Kong equity market, and the commodity market.

Session types per market:

U.S. equity market: "PRE_MARKET", "REGULAR", "AFTER_MARKET", "OVERNIGHT", "NO_TRADING".
Commodity market: "REGULAR", "NO_TRADING".
Korean equity market: "REGULAR", "NO_TRADING".
Hong Kong equity market: "REGULAR", "NO_TRADING".

GET

/fapi/v1/tradingSchedule

https://fapi.binance.com

Trading Schedule › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight5

Trading Schedule › Responses

200

Trading Schedule

updateTime

integer · int64

Example: 1761286643918

object

Example: {}

object

Example: {}

object[]

Example: []

startTime

integer · int64

Example: 1761177600000

endTime

integer · int64

Example: 1761206400000

type

string

Example: OVERNIGHT

object

Example: {}

object[]

Example: []

startTime

integer · int64

Example: 1761724800000

endTime

integer · int64

Example: 1761744600000

type

string

Example: NO_TRADING

object

Example: {}

object[]

Example: []

startTime

integer · int64

Example: 1779958800000

endTime

integer · int64

Example: 1780009200000

type

string

Example: NO_TRADING

object

Example: {}

object[]

Example: []

startTime

integer · int64

Example: 1779955200000

endTime

integer · int64

Example: 1780018200000

type

string

Example: NO_TRADING

GET/fapi/v1/tradingSchedule

curl --request GET \
  --url https://fapi.binance.com/fapi/v1/tradingSchedule

Example Responses

{
  "updateTime": 1761286643918,
  "marketSchedules": {}
}

application/json