Query future basis
If startTime and endTime are not sent, the most recent data is returned. Only the data of the latest 30 days is available.
Weight: 0
Request parameters.
Test connectivity to the Rest API and get the current server time.
Weight: 1
Query composite index symbol information
Only for composite index symbols
Weight: 1
Request parameters.
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.
support querying futures trade histories that are not older than one year
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
Weight: 20
Request parameters.
Kline/candlestick bars for a specific contract type. Klines are uniquely identified by their open time.
If startTime and endTime are not sent, the most recent klines are returned. Contract type: PERPETUAL CURRENT_QUARTER NEXT_QUARTER
Weight: based on parameter LIMIT
| LIMIT | weight |
|---|---|
| [1,100) | 1 |
| [100, 500) | 2 |
| [500, 1000] | 5 |
| > 1000 | 10 |
Request parameters.
Current exchange trading rules and symbol information
Weight: 1
Get Funding Rate History
If startTime and endTime are not sent, the most recent limit datas are returned.
If the number of data between startTime and endTime is larger than limit, return as startTime + limit.
In ascending order.
Weight: share 500/5min/IP rate limit with GET /fapi/v1/fundingInfo
Request parameters.
Query funding rate info for symbols that had FundingRateCap/ FundingRateFloor / fundingIntervalHours adjustment
Weight: 0 share 500/5min/IP rate limit with GET /fapi/v1/fundingInfo
Kline/candlestick bars for the index price of a pair. Klines are uniquely identified by their open time.
If startTime and endTime are not sent, the most recent klines are returned.
Weight: based on parameter LIMIT
| LIMIT | weight |
|---|---|
| [1,100) | 1 |
| [100, 500) | 2 |
| [500, 1000] | 5 |
| > 1000 | 10 |
Request parameters.
Kline/candlestick bars for a symbol. Klines are uniquely identified by their open time.
If startTime and endTime are not sent, the most recent klines are returned.
Weight: based on parameter LIMIT
| LIMIT | weight |
|---|---|
| [1,100) | 1 |
| [100, 500) | 2 |
| [500, 1000] | 5 |
| > 1000 | 10 |
Request parameters.
Query symbol Long/Short Ratio
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
Weight: 0
Request parameters.
Mark Price and Funding Rate
Weight: 1
Request parameters.
Kline/candlestick bars for the mark price of a symbol. Klines are uniquely identified by their open time.
If startTime and endTime are not sent, the most recent klines are returned.
Weight: based on parameter LIMIT
| LIMIT | weight |
|---|---|
| [1,100) | 1 |
| [100, 500) | 2 |
| [500, 1000] | 5 |
| > 1000 | 10 |
Request parameters.
asset index for Multi-Assets mode
Weight: 1 for a single symbol; 10 when the symbol parameter is omitted
Request parameters.
Get older market historical trades.
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 three months
Weight: 20
Request parameters.
Get present open interest of a specific symbol.
Weight: 1
Request parameters.
Open Interest Statistics
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
Weight: 0
Request parameters.
Query symbol orderbook
Weight: Adjusted based on the limit:
| Limit | Weight |
|---|---|
| 5, 10, 20, 50 | 2 |
| 100 | 5 |
| 500 | 10 |
| 1000 | 20 |
Request parameters.
Premium index kline bars of a symbol. Klines are uniquely identified by their open time.
If startTime and endTime are not sent, the most recent klines are returned.
Weight: based on parameter LIMIT
| LIMIT | weight |
|---|---|
| [1,100) | 1 |
| [100, 500) | 2 |
| [500, 1000] | 5 |
| > 1000 | 10 |
Request parameters.
Latest price for a symbol or symbols.
Weight: 0
Request parameters.
Query index price constituents
Weight: 2
Request parameters.
Query Insurance Fund Balance Snapshot
Weight: 1
Request parameters.
Get recent market trades
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.
Weight: 5
Request parameters.
Best price/qty on the order book for a symbol or symbols.
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.
Weight: 2 for a single symbol; 5 when the symbol parameter is omitted
Request parameters.
Latest price for a symbol or symbols.
If the symbol is not sent, prices for all symbols will be returned in an array.
Weight: 1 for a single symbol; 2 when the symbol parameter is omitted
Request parameters.
Latest price for a symbol or symbols.
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.
Weight: 1 for a single symbol; 2 when the symbol parameter is omitted
Request parameters.
Taker Buy/Sell Volume
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
Weight: 0
Request parameters.
Test connectivity to the Rest API.
Weight: 1
24 hour rolling window price change statistics. Careful* when accessing this with no symbol.
If the symbol is not sent, tickers for all symbols will be returned in an array.
Weight: 1 for a single symbol; 40 when the symbol parameter is omitted
Request parameters.
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 %
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
Weight: 0
Request parameters.
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 %
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
Weight: 0
Request parameters.
MarketDataApi - object-oriented interface MarketDataApi