Class MarketDataApi

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.

Weight(IP): 1

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.

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

Query future basis

Weight(IP): 0

Notes:

• If startTime and endTime are not sent, the most recent data is returned.
• Only the data of the latest 30 days is available.

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

Weight(IP): 1

Query composite index symbol information

Weight(IP): 1

Notes:

• Only for composite index symbols

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.

Weight(IP): 20

Notes:

• support querying futures trade histories that are not older than 24 hours
• If both startTime and endTime are sent, time between startTime and endTime must be less than 1 hour.
• If fromId, startTime, and endTime are not sent, the most recent aggregate trades will be returned.
• Only market trades will be aggregated and returned, which means the insurance fund trades and ADL trades won't be aggregated.
• Sending both startTime/endTime and fromId might cause response timeout, please send either fromId or startTime/endTime

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

Weight: based on parameter LIMIT

Notes:

• If startTime and endTime are not sent, the most recent klines are returned.

Current exchange trading rules and symbol information

Weight(IP): 1

Get Funding Rate History

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

Notes:

• If startTime and endTime are not sent, the most recent 200 records are returned.
• If the number of data between startTime and endTime is larger than limit, return as startTime + limit.
• In ascending order.

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

Weight: 0

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

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

Weight: based on parameter LIMIT

Notes:

• If startTime and endTime are not sent, the most recent klines are returned.

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

Weight: based on parameter LIMIT

Notes:

• If startTime and endTime are not sent, the most recent klines are returned.

Query symbol Long/Short Ratio

Weight(IP): 0

Notes:

• If startTime and endTime are not sent, the most recent data is returned.
• Only the data of the latest 30 days is available.
• IP rate limit 1000 requests/5min

Mark Price and Funding Rate

Weight: 1 with symbol, 10 without symbol

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

Weight: based on parameter LIMIT

Notes:

• If startTime and endTime are not sent, the most recent klines are returned.

Get older market historical trades.

Weight(IP): 20

Security Type: MARKET_DATA

Notes:

• Market trades means trades filled in the order book. Only market trades will be returned, which means the insurance fund trades and ADL trades won't be returned.
• Only supports data from within the last one month

Get present open interest of a specific symbol.

Weight(IP): 1

Open Interest Statistics

Weight(IP): 0

Notes:

• If startTime and endTime are not sent, the most recent data is returned.
• Only the data of the latest 1 month is available.
• IP rate limit 1000 requests/5min

Query symbol orderbook

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

Weight: Adjusted based on the limit:

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

Weight: based on parameter LIMIT

Notes:

• If startTime and endTime are not sent, the most recent klines are returned.

Latest price for a symbol or symbols.

Weight(IP): 0

Query index price constituents

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

Weight(IP): 2

Query Insurance Fund Balance Snapshot

Weight(IP): 1

Get recent market trades

Weight(IP): 5

Notes:

• Market trades means trades filled in the order book. Only market trades will be returned, which means the insurance fund trades and ADL trades won't be returned.

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.

Weight: Adjusted based on the limit:

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.

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

Notes:

• If the symbol is not sent, bookTickers for all symbols will be returned in an array.
• The field X-MBX-USED-WEIGHT-1M in response header is not accurate from this endpoint, please ignore.

Latest price for a symbol or symbols.

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

Notes:

• If the symbol is not sent, prices for all symbols will be returned in an array.

Latest price for a symbol or symbols.

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

Notes:

• If the symbol is not sent, prices for all symbols will be returned in an array.
• The field X-MBX-USED-WEIGHT-1M in response header is not accurate from this endpoint, please ignore.

Taker Buy/Sell Volume

Weight(IP): 0

Notes:

• If startTime and endTime are not sent, the most recent data is returned.
• Only the data of the latest 30 days is available.
• IP rate limit 1000 requests/5min

Test connectivity to the Rest API.

Weight(IP): 1

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

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

Notes:

• If the symbol is not sent, tickers for all symbols will be returned in an array.

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 %

Security Type: MARKET_DATA

Notes:

• If startTime and endTime are not sent, the most recent data is returned.
• Only the data of the latest 30 days is available.
• IP rate limit 1000 requests/5min

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 %

Weight(IP): 0

Security Type: MARKET_DATA

Notes:

• If startTime and endTime are not sent, the most recent data is returned.
• Only the data of the latest 30 days is available.
• IP rate limit 1000 requests/5min

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".

Weight(IP): 5