Binance for ChatGPT lets you access and explore Binance public, read-only market data using natural language. Retrieve current and historical prices, order books, recent trades, candlesticks (klines), and exchange metadata across Spot, Futures, and Options. No authentication is required. This app does not access user accounts and does not support trading or transactions.
Market data is provided “as is” from Binance’s public APIs and may be delayed, incomplete, or subject to change. This information is for informational purposes only and should not be relied upon for trading or financial decisions. Binance makes no representations or warranties regarding accuracy or timeliness and disclaims all liability arising from use of this data.
get_futures_coin_24hr_ticker_price_change_statistics24 hour rolling window price change statistics.
Weight: 1 for a single symbol, 40 when the symbol parameter is omitted Careful when accessing this with no symbol.
pairstringPair
symbolstringSymbol
get_futures_coin_basisQuery basis
contractTypestringContract type.
PERPETUALCURRENT_QUARTERNEXT_QUARTERpairstringPair.
periodstringPeriod interval.
5m15m30m1h2h4h6h12h1dendTimeintegerlimitintegerMaximum number of records to return.
startTimeintegerget_futures_coin_compressed_aggregate_trades_listGet compressed, aggregate trades. Market trades that fill in 100ms with the same price and the same taking side will have the quantity aggregated.
symbolstringSymbol
endTimeintegerTimestamp in ms to get aggregate trades until INCLUSIVE.
fromIdintegerID to get aggregate trades from INCLUSIVE.
limitintegerMaximum number of records to return.
startTimeintegerTimestamp in ms to get aggregate trades from INCLUSIVE.
get_futures_coin_continuous_contract_kline_candlestick_dataKline/candlestick bars for a specific contract type. Klines are uniquely identified by their open time.
Weight: based on parameter LIMIT
| LIMIT | weight | |
|
| | [1,100) | 1 | | [100, 500) | 2 | | [500, 1000] | 5 | | > 1000 | 10 |
contractTypestringALL, CURRENT_QUARTER, NEXT_QUARTER, PERPETUAL
PERPETUALCURRENT_QUARTERNEXT_QUARTERintervalstringInterval
1m3m5m15m30m1h2h4h6h8h12h1d3d1w1MpairstringAfter CM migration, accepts both CM and UM pair values.
endTimeintegerEnd time
limitintegerMaximum number of records to return.
startTimeintegerStart time
get_futures_coin_exchange_informationCurrent exchange trading rules and symbol information
get_futures_coin_funding_rate_history_of_perpetual_futuresGet Funding Rate History of Perpetual Futures
symbolstringSymbol
endTimeintegerTimestamp in ms to get funding rate until INCLUSIVE.
limitintegerMaximum number of records to return.
startTimeintegerTimestamp in ms to get funding rate from INCLUSIVE.
get_futures_coin_funding_rate_infoQuery funding rate info for symbols that had FundingRateCap/FundingRateFloor/fundingIntervalHours adjustment
get_futures_coin_index_price_and_mark_priceQuery index price and mark price
pairstringsymbolstringget_futures_coin_index_price_kline_candlestick_dataKline/candlestick bars for the index price of a pair. Klines are uniquely identified by their open time.
Weight: Based on parameter LIMIT
| LIMIT | weight | |
|
| | [1,100) | 1 | | [100, 500) | 2 | | [500, 1000] | 5 | | > 1000 | 10 |
intervalstringInterval
1m3m5m15m30m1h2h4h6h8h12h1d3d1w1MpairstringAfter CM migration, accepts both CM and UM pair values.
endTimeintegerEnd time
limitintegerMaximum number of records to return.
startTimeintegerStart time
get_futures_coin_kline_candlestick_dataKline/candlestick bars for a symbol. Klines are uniquely identified by their open time.
Weight: Based on parameter LIMIT
| LIMIT | weight | |
|
| | [1,100) | 1 | | [100, 500) | 2 | | [500, 1000] | 5 | | > 1000 | 10 |
intervalstringInterval
1m3m5m15m30m1h2h4h6h8h12h1d3d1w1MsymbolstringAfter CM migration, accepts both CM and UM symbols.
endTimeintegerEnd time
limitintegerMaximum number of records to return.
startTimeintegerStart time
get_futures_coin_long_short_ratioQuery symbol Long/Short Ratio
pairstringBTCUSD
periodstring"5m","15m","30m","1h","2h","4h","6h","12h","1d"
5m15m30m1h2h4h6h12h1dcontractTypestringContract type filter. If omitted, returns aggregated data across all contract types.
PERPETUALCURRENT_QUARTERNEXT_QUARTERendTimeintegerlimitintegerMaximum number of records to return.
startTimeintegerget_futures_coin_mark_price_kline_candlestick_dataKline/candlestick bars for the mark price of a symbol. Klines are uniquely identified by their open time.
Weight: Based on parameter LIMIT
| LIMIT | weight | |
|
| | [1,100) | 1 | | [100, 500) | 2 | | [500, 1000] | 5 | | > 1000 | 10 |
intervalstringInterval
1m3m5m15m30m1h2h4h6h8h12h1d3d1w1MsymbolstringAfter CM migration, accepts both CM and UM symbols.
endTimeintegerEnd time
limitintegerMaximum number of records to return.
startTimeintegerStart time
get_futures_coin_old_trades_lookupGet older market historical trades.
symbolstringSymbol
fromIdintegerTradeId to fetch from. Default gets most recent trades.
limitintegerMaximum number of records to return.
get_futures_coin_open_interestGet present open interest of a specific symbol.
symbolstringSymbol
get_futures_coin_open_interest_statisticsQuery open interest stats
pairstringBTCUSD
periodstring"5m","15m","30m","1h","2h","4h","6h","12h","1d"
5m15m30m1h2h4h6h12h1dcontractTypestringContract type filter. If omitted, returns aggregated data across all contract types.
PERPETUALCURRENT_QUARTERNEXT_QUARTERendTimeintegerlimitintegerMaximum number of records to return.
startTimeintegerget_futures_coin_order_bookQuery orderbook on specific symbol
Weight: Adjusted based on the limit:
| Limit | Weight | | ------------ | ------------ | | 5, 10, 20, 50 | 2 | | 100 | 5 | | 500 | 10 | | 1000 | 20 |
symbolstringSymbol
limitintegerValid limits:[5, 10, 20, 50, 100, 500, 1000].
get_futures_coin_premium_index_kline_dataPremium index kline bars of a symbol. Klines are uniquely identified by their open time.
Weight: Based on parameter LIMIT
| LIMIT | weight | | ----------- | ------ | | [1,100) | 1 | | [100, 500) | 2 | | [500, 1000] | 5 | | > 1000 | 10 |
intervalstringInterval
1m3m5m15m30m1h2h4h6h8h12h1d3d1w1MsymbolstringAfter CM migration, accepts both CM and UM symbols.
endTimeintegerEnd time
limitintegerMaximum number of records to return.
startTimeintegerStart time
get_futures_coin_recent_trades_listGet recent market trades
symbolstringSymbol
limitintegerMaximum number of records to return.
get_futures_coin_symbol_order_book_tickerBest price/qty on the order book for a symbol or symbols.
Weight: 2 for a single symbol, 5 when the symbol parameter is omitted
pairstringSymbol
symbolstringSymbol
get_futures_coin_symbol_price_tickerLatest price for a symbol or symbols.
Weight: 1 for a single symbol, 2 when the symbol parameter is omitted
pairstringPair
symbolstringSymbol
get_futures_coin_taker_buy_sell_volumeTaker Buy Volume: the total volume of buy orders filled by takers within the period.
Taker Sell Volume: the total volume of sell orders filled by takers within the period.
contractTypestringALL, CURRENT_QUARTER, NEXT_QUARTER, PERPETUAL
ALLPERPETUALCURRENT_QUARTERNEXT_QUARTERpairstringBTCUSD
periodstring"5m","15m","30m","1h","2h","4h","6h","12h","1d"
5m15m30m1h2h4h6h12h1dendTimeintegerlimitintegerMaximum number of records to return.
startTimeintegerget_futures_coin_top_trader_long_short_ratio_accountsThe 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 %
pairstringPair
periodstring"5m","15m","30m","1h","2h","4h","6h","12h","1d"
5m15m30m1h2h4h6h12h1dsymbolstringcontractTypestringContract type filter. If omitted, returns aggregated data across all contract types.
PERPETUALCURRENT_QUARTERNEXT_QUARTERendTimeintegerlimitintegerMaximum number of records to return.
startTimeintegerget_futures_coin_top_trader_long_short_ratio_positionsThe 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 %
pairstringBTCUSD
periodstring"5m","15m","30m","1h","2h","4h","6h","12h","1d"
5m15m30m1h2h4h6h12h1dcontractTypestringContract type filter. If omitted, returns aggregated data across all contract types.
PERPETUALCURRENT_QUARTERNEXT_QUARTERendTimeintegerlimitintegerMaximum number of records to return.
startTimeintegerget_futures_usds_24hr_ticker_price_change_statistics24 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
symbolstringget_futures_usds_asset_indexAsset 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
symbolstringAsset pair
get_futures_usds_auto_deleveraging_riskQuery 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.
symbolstringSymbol
get_futures_usds_basisQuery future basis
contractTypestringPERPETUALCURRENT_QUARTERNEXT_QUARTERpairstringperiodstring"5m","15m","30m","1h","2h","4h","6h","12h","1d"
5m15m30m1h2h4h6h12h1dendTimeintegerlimitintegerDefault 100; max 1000
startTimeintegerget_futures_usds_composite_index_symbol_informationQuery composite index symbol information
symbolstringget_futures_usds_compressed_aggregate_trades_listGet 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.
symbolstringSymbol
endTimeintegerTimestamp in ms to get aggregate trades until INCLUSIVE.
fromIdintegerID to get aggregate trades from INCLUSIVE.
limitintegerDefault 100; max 1000
startTimeintegerTimestamp in ms to get aggregate trades from INCLUSIVE.
get_futures_usds_continuous_contract_kline_candlestick_dataKline/candlestick bars for a specific contract type. Klines are uniquely identified by their open time.
Weight: based on parameter LIMIT
| LIMIT | weight | | ----------- | ------ | | [1,100) | 1 | | [100, 500) | 2 | | [500, 1000] | 5 | | > 1000 | 10 |
contractTypestringFuturestype
PERPETUALCURRENT_QUARTERNEXT_QUARTERTRADIFI_PERPETUALintervalstring1m3m5m15m30m1h2h4h6h8h12h1d3d1w1MpairstringAfter CM migration, accepts both UM and CM pair values.
endTimeintegerEnd time
limitintegerDefault 100; max 1000
startTimeintegerStart time
get_futures_usds_exchange_informationCurrent exchange trading rules and symbol information
get_futures_usds_funding_rate_historyGet Funding Rate History
Weight: share 500/5min/IP rate limit with GET /fapi/v1/fundingInfo
endTimeintegerTimestamp in ms to get funding rate until INCLUSIVE.
limitintegerDefault 100; max 1000
startTimeintegerTimestamp in ms to get funding rate from INCLUSIVE.
symbolstringget_futures_usds_funding_rate_infoQuery funding rate info for symbols that had FundingRateCap/FundingRateFloor / fundingIntervalHours adjustment
Weight: 0
share 500/5min/IP rate limit with GET /fapi/v1/fundingRate
get_futures_usds_index_price_kline_candlestick_dataKline/candlestick bars for the index price of a pair. Klines are uniquely identified by their open time.
Weight: based on parameter LIMIT
| LIMIT | weight | | ----------- | ------ | | [1,100) | 1 | | [100, 500) | 2 | | [500, 1000] | 5 | | > 1000 | 10 |
intervalstring1m3m5m15m30m1h2h4h6h8h12h1d3d1w1MpairstringAfter CM migration, accepts both UM and CM pair values.
endTimeintegerEnd time
limitintegerDefault 100; max 1000
startTimeintegerStart time
get_futures_usds_kline_candlestick_dataKline/candlestick bars for a symbol. Klines are uniquely identified by their open time.
Weight: based on parameter LIMIT
| LIMIT | weight | | ----------- | ------ | | [1,100) | 1 | | [100, 500) | 2 | | [500, 1000] | 5 | | > 1000 | 10 |
intervalstring1m3m5m15m30m1h2h4h6h8h12h1d3d1w1MsymbolstringAfter CM migration, accepts both UM and CM symbols.
endTimeintegerEnd time
limitintegerDefault 100; max 1000
startTimeintegerStart time
get_futures_usds_long_short_ratioQuery symbol Long/Short Ratio
periodstring"5m","15m","30m","1h","2h","4h","6h","12h","1d"
5m15m30m1h2h4h6h12h1dsymbolstringendTimeintegerlimitintegerDefault 100; max 1000
startTimeintegerget_futures_usds_mark_priceMark Price and Funding Rate
Weight: 1 with symbol, 10 without symbol
symbolstringget_futures_usds_mark_price_kline_candlestick_dataKline/candlestick bars for the mark price of a symbol. Klines are uniquely identified by their open time.
Weight: based on parameter LIMIT
| LIMIT | weight | | ----------- | ------ | | [1,100) | 1 | | [100, 500) | 2 | | [500, 1000] | 5 | | > 1000 | 10 |
intervalstring1m3m5m15m30m1h2h4h6h8h12h1d3d1w1MsymbolstringAfter CM migration, accepts both UM and CM symbols.
endTimeintegerEnd time
limitintegerDefault 100; max 1000
startTimeintegerStart time
get_futures_usds_multi_assets_mode_asset_indexasset index for Multi-Assets mode
Weight: 1 for a single symbol; 10 when the symbol parameter is omitted
Docs: https://developers.binance.com/docs/derivatives/usds-margined-futures/market-data/rest-api/Multi-Assets-Mode-Asset-Index
symbolstringget_futures_usds_old_trades_lookupGet older market historical trades.
symbolstringfromIdintegerTradeId to fetch from. Default gets most recent trades.
limitintegerDefault 100; max 1000
get_futures_usds_open_interestGet present open interest of a specific symbol.
symbolstringget_futures_usds_open_interest_statisticsOpen Interest Statistics
periodstring"5m","15m","30m","1h","2h","4h","6h","12h","1d"
5m15m30m1h2h4h6h12h1dsymbolstringendTimeintegerlimitintegerDefault 100; max 1000
startTimeintegerget_futures_usds_order_bookQuery symbol orderbook
Retail Price Improvement(RPI) orders are not visible and excluded in the response message.
Weight: Adjusted based on the limit:
| Limit | Weight | | ------------- | ------ | | 5, 10, 20, 50 | 2 | | 100 | 5 | | 500 | 10 | | 1000 | 20 |
symbolstringlimitintegerValid limits:[5, 10, 20, 50, 100, 500, 1000]
get_futures_usds_premium_index_kline_dataPremium index kline bars of a symbol. Klines are uniquely identified by their open time.
Weight: based on parameter LIMIT
| LIMIT | weight | | ----------- | ------ | | [1,100) | 1 | | [100, 500) | 2 | | [500, 1000] | 5 | | > 1000 | 10 |
intervalstring1m3m5m15m30m1h2h4h6h8h12h1d3d1w1MsymbolstringAfter CM migration, accepts both UM and CM symbols.
endTimeintegerEnd time
limitintegerDefault 100; max 1000
startTimeintegerStart time
get_futures_usds_quarterly_contract_settlement_priceLatest price for a symbol or symbols.
pairstringget_futures_usds_recent_trades_listGet recent market trades
symbolstringlimitintegerDefault 100; max 1000
get_futures_usds_retail_price_index_order_bookQuery 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:
| Limit | Weight | | ------------- | ------ | | 1000 | 20 |
symbolstringlimitintegerValid limits:[1000]
get_futures_usds_symbol_order_book_tickerBest 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
symbolstringget_futures_usds_symbol_price_tickerLatest price for a symbol or symbols.
Weight: 1 for a single symbol; 2 when the symbol parameter is omitted
symbolstringget_futures_usds_symbol_price_ticker_v2Latest price for a symbol or symbols.
Weight: 1 for a single symbol; 2 when the symbol parameter is omitted
symbolstringget_futures_usds_taker_buy_sell_volumeTaker Buy/Sell Volume
periodstring"5m","15m","30m","1h","2h","4h","6h","12h","1d"
5m15m30m1h2h4h6h12h1dsymbolstringendTimeintegerlimitintegerDefault 100; max 1000
startTimeintegerget_futures_usds_top_trader_long_short_ratio_accountsThe 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 %
periodstring"5m","15m","30m","1h","2h","4h","6h","12h","1d"
5m15m30m1h2h4h6h12h1dsymbolstringendTimeintegerlimitintegerDefault 100; max 1000
startTimeintegerget_futures_usds_top_trader_long_short_ratio_positionsThe 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 %
periodstring"5m","15m","30m","1h","2h","4h","6h","12h","1d"
5m15m30m1h2h4h6h12h1dsymbolstringendTimeintegerlimitintegerDefault 100; max 1000
startTimeintegerget_futures_usds_trading_scheduleTrading 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, China equity market, and the commodity market.
Session types per market:
get_options_24hr_ticker_price_change_statistics24 hour rolling window price change statistics.
Weight: 1 for a single symbol; 40 when the symbol parameter is omitted
symbolstringOption trading pair
get_options_exchange_informationCurrent exchange trading rules and symbol information
get_options_historical_exercise_recordsGet historical exercise records.
endTimeintegerEnd Time, e.g 1593512200000
limitintegerNumber of result sets returned
startTimeintegerStart Time, e.g 1593511200000
underlyingstringUnderlying asset.
get_options_index_priceGet spot index price for option underlying.
underlyingstringUnderlying asset.
get_options_kline_candlestick_dataKline/candlestick bars for an option symbol. Klines are uniquely identified by their open time.
intervalstringTime interval
1m3m5m15m30m1h2h4h6h8h12h1d3d1w1MsymbolstringOption trading pair
endTimeintegerEnd Time, e.g 1593512200000
limitintegerNumber of result sets returned
startTimeintegerStart Time, e.g 1593511200000
get_options_open_interestGet open interest for specific underlying asset on specific expiration date.
expirationstringexpiration date
underlyingAssetstringUnderlying asset.
get_options_option_mark_priceOption mark price and greek info.
symbolstringOption trading pair
get_options_order_bookCheck orderbook depth on specific symbol
Weight: limit | weight ------------ | ------------ 5, 10, 20, 50 | 1 100 | 5 500 | 10 1000 | 20
symbolstringOption trading pair
limitintegerDefault:100 Max:1000.Optional value:[10, 20, 50, 100, 500, 1000]
get_options_recent_block_trades_listGet recent block trades
limitintegerNumber of records
symbolstringOption trading pair
get_options_recent_trades_listGet recent market trades
symbolstringOption trading pair
limitintegerNumber of result sets returned
get_portfolio_margin_collateral_ratePortfolio Margin Collateral Rate
get_spot_24hr_ticker_price_change_statistics24 hour rolling window price change statistics. Careful when accessing this with no symbol.
Weight: <table> <thead> <tr> <th>Parameter</th> <th>Symbols Provided</th> <th>Weight</th> </tr> </thead> <tbody> <tr> <td rowspan="2">symbol</td> <td>1</td> <td>2</td> </tr> <tr> <td>symbol parameter is omitted</td> <td>80</td> </tr> <tr> <td rowspan="4">symbols</td> <td>1-20</td> <td>2</td> </tr> <tr> <td>21-100</td> <td>40</td> </tr> <tr> <td>101 or more</td> <td>80</td> </tr> <tr> <td>symbols parameter is omitted</td> <td>80</td> </tr> </tbody> </table>
symbolstringEither `symbol` or `symbols` must be provided
symbolsarrayEither `symbol` or `symbols` must be provided Examples of accepted format for the `symbols` parameter: ["BTCUSDT","BNBUSDT"] or %5B%22BTCUSDT%22,%22BNBUSDT%22%5D The maximum number of symbols allowed in a request is 100.
symbolStatusstringFilters for symbols that have this `tradingStatus`. For a single symbol, a status mismatch returns error `-1220 SYMBOL_DOES_NOT_MATCH_STATUS`. For multiple symbols, non-matching ones are simply excluded from the response.
TRADINGHALTBREAKtypestringFULLMINIget_spot_compressed_aggregate_trades_listGet compressed, aggregate trades. Trades that fill at the time, from the same taker order, with the same price will have the quantity aggregated.
symbolstringendTimeintegerTimestamp in ms to get aggregate trades until INCLUSIVE.
fromIdintegerID to get aggregate trades from INCLUSIVE.
limitintegerDefault: 500; Maximum: 1000.
startTimeintegerTimestamp in ms to get aggregate trades from INCLUSIVE.
get_spot_current_average_priceCurrent average price for a symbol.
symbolstringget_spot_exchange_informationCurrent exchange trading rules and symbol information
permissionsarrayExamples: curl -X GET "https://api.binance.com/api/v3/exchangeInfo?permissions=SPOT" curl -X GET "https://api.binance.com/api/v3/exchangeInfo?permissions=%5B%22MARGIN%22%2C%22LEVERAGED%22%5D" or curl -g -X GET 'https://api.binance.com/api/v3/exchangeInfo?permissions=["MARGIN","LEVERAGED"]'
showPermissionSetsbooleanControls whether the content of the `permissionSets` field is populated or not.
symbolstringExample: curl -X GET "https://api.binance.com/api/v3/exchangeInfo?symbol=BNBBTC"
symbolsarrayExamples: curl -X GET "https://api.binance.com/api/v3/exchangeInfo?symbols=%5B%22BNBBTC%22,%22BTCUSDT%22%5D" or curl -g -X GET 'https://api.binance.com/api/v3/exchangeInfo?symbols=["BTCUSDT","BNBBTC"]'
symbolStatusstringFilters for symbols that have this `tradingStatus`. Cannot be used in combination with `symbols` or `symbol`.
TRADINGHALTBREAKget_spot_historical_block_tradesGet block trades. Weight: 25
Docs: https://developers.binance.com/docs/binance-spot-api-docs/rest-api/market-data-endpoints#historical-block-trades
fromIdintegerBlock trade ID to fetch from
symbolstringlimitintegerDefault: 500; Maximum: 1000
get_spot_kline_candlestick_dataKline/candlestick bars for a symbol. Klines are uniquely identified by their open time.
intervalstring1s1m3m5m15m30m1h2h4h6h8h12h1d3d1w1MsymbolstringendTimeintegerTimestamp in ms to get aggregate trades until INCLUSIVE.
limitintegerDefault: 500; Maximum: 1000.
startTimeintegerTimestamp in ms to get aggregate trades from INCLUSIVE.
timeZonestringDefault: 0 (UTC)
get_spot_old_trade_lookupGet older trades.
symbolstringfromIdintegerTradeId to fetch from. Default gets most recent trades.
limitintegerDefault: 500; Maximum: 1000.
get_spot_order_bookOrder book
Weight: Adjusted based on the limit:
|Limit|Request Weight ------|------- 1-100| 5 101-500| 25 501-1000| 50 1001-5000| 250
symbolstringlimitintegerIf limit > 5000, only 5000 entries will be returned.
symbolStatusstringFilters for symbols that have this `tradingStatus`. A status mismatch returns error `-1220 SYMBOL_DOES_NOT_MATCH_STATUS`.
TRADINGHALTBREAKget_spot_recent_trades_listGet recent trades.
symbolstringlimitintegerDefault: 500; Maximum: 1000.
get_spot_rolling_window_price_change_statisticsNote: This endpoint differs from GET /api/v3/ticker/24hr.
The statistical time range of this endpoint can be up to 59999ms longer than the requested windowSize.
openTime starts at the beginning of a minute, while the end time is the current time. Therefore, the actual interval can be up to 59999ms longer than the requested window.
For example, if closeTime is 1641287867099 (January 04, 2022 09:17:47:099 UTC) and windowSize is 1d, then openTime is 1641201420000 (January 3, 2022, 09:17:00 UTC).
Weight: 4 for each requested symbol regardless of windowSize.
The weight for this request will cap at 200 once the number of symbols in the request is more than 50.
symbolstringEither `symbol` or `symbols` must be provided
symbolsarrayEither `symbol` or `symbols` must be provided Examples of accepted format for the `symbols` parameter: ["BTCUSDT","BNBUSDT"] or %5B%22BTCUSDT%22,%22BNBUSDT%22%5D The maximum number of symbols allowed in a request is 100.
symbolStatusstringFilters for symbols that have this `tradingStatus`. For a single symbol, a status mismatch returns error `-1220 SYMBOL_DOES_NOT_MATCH_STATUS`. For multiple symbols, non-matching ones are simply excluded from the response.
TRADINGHALTBREAKtypestringFULLMINIwindowSizestringUnits cannot be combined (e.g. `1d2h` is not allowed).
1m2m3m4m5m6m7m8m9m10m11m12m13m14m15m16m17m18m19m20m21m22m23m24m25m26m27m28m29m30m31m32m33m34m35m36m37m38m39m40m41m42m43m44m45m46m47m48m49m50m51m52m53m54m55m56m57m58m59m1h2h3h4h5h6h7h8h9h10h11h12h13h14h15h16h17h18h19h20h21h22h23h1d2d3d4d5d6d7dget_spot_symbol_order_book_tickerBest price/qty on the order book for a symbol or symbols.
Weight: |Parameter|Symbols Provided|Weight| |---|---|---| |symbol| 1 |2| | |omitted| 4| |symbols| Any |4|
symbolstringParameter symbol and symbols cannot be used in combination. If neither parameter is sent, `bookTickers` for all symbols will be returned in an array.
symbolsarrayParameter symbol and symbols cannot be used in combination. If neither parameter is sent, `bookTickers` for all symbols will be returned in an array. Examples of accepted format for the symbols parameter: ["BTCUSDT","BNBUSDT"] or %5B%22BTCUSDT%22,%22BNBUSDT%22%5D
symbolStatusstringFilters for symbols that have this `tradingStatus`. For a single symbol, a status mismatch returns error `-1220 SYMBOL_DOES_NOT_MATCH_STATUS`. For multiple or all symbols, non-matching ones are simply excluded from the response.
TRADINGHALTBREAKget_spot_symbol_price_tickerLatest price for a symbol or symbols.
Weight: |Parameter|Symbols Provided|Weight| |---|---|---| |symbol| 1 |2| | |omitted| 4| |symbols| Any |4|
symbolstringParameter symbol and symbols cannot be used in combination. If neither parameter is sent, prices for all symbols will be returned in an array.
symbolsarrayParameter symbol and symbols cannot be used in combination. If neither parameter is sent, prices for all symbols will be returned in an array. Examples of accepted format for the symbols parameter: ["BTCUSDT","BNBUSDT"] or %5B%22BTCUSDT%22,%22BNBUSDT%22%5D
symbolStatusstringFilters for symbols that have this `tradingStatus`. For a single symbol, a status mismatch returns error `-1220 SYMBOL_DOES_NOT_MATCH_STATUS`. For multiple or all symbols, non-matching ones are simply excluded from the response.
TRADINGHALTBREAKget_spot_trading_day_tickerPrice change statistics for a trading day.
Weight: 4 for each requested symbol. The weight for this request will cap at 200 once the number of symbols in the request is more than 50.
symbolstringEither `symbol` or `symbols` must be provided.
symbolsarrayEither `symbol` or `symbols` must be provided. Examples of accepted format for the `symbols` parameter: ["BTCUSDT","BNBUSDT"] or %5B%22BTCUSDT%22,%22BNBUSDT%22%5D. The maximum number of `symbols` allowed in a request is 100.
symbolStatusstringFilters for symbols that have this `tradingStatus`. For a single symbol, a status mismatch returns error `-1220 SYMBOL_DOES_NOT_MATCH_STATUS`. For multiple symbols, non-matching ones are simply excluded from the response.
TRADINGHALTBREAKtimeZonestringDefault: 0 (UTC)
typestringFULLMINIget_spot_ui_kline_candlestick_dataThe request is similar to klines having the same parameters and response.
uiKlines return modified kline data, optimized for presentation of candlestick charts.
intervalstring1s1m3m5m15m30m1h2h4h6h8h12h1d3d1w1MsymbolstringendTimeintegerTimestamp in ms to get aggregate trades until INCLUSIVE.
limitintegerDefault: 500; Maximum: 1000.
startTimeintegerTimestamp in ms to get aggregate trades from INCLUSIVE.
timeZonestringDefault: 0 (UTC)
hot_categoryGet cryptocurrency hot categories overview including market cap, trading volume, 24h change, and top tokens per category. Use this when users ask about crypto category performance, category trends, or want to explore tokens by industry category (e.g., DeFi, Layer 2, AI, Meme, GameFi).
hot_coinGet trending hot coins with rankings, price changes, market sentiment, and top player movements. Use this when users ask about trending coins, hot tokens, or what coins are popular right now.
rank_typestringlist_futures_usds_all_convert_pairsQuery for all convertible token pairs and the tokens’ respective upper/lower limits
fromAssetstringUser spends coin
toAssetstringUser receives coin
market_overviewGet cryptocurrency market overview including market cap, trading volume, fear/greed index, market analysis, news, and hot tokens carousel. Use this when users ask about overall crypto market conditions, market sentiment, or want to see trending tokens.
langstringenquery_futures_coin_index_price_constituentsQuery index price constituents
symbolstringSymbol
query_futures_usds_index_price_constituentsQuery index price constituents
Note: Prices from constituents of TradFi perps will be hiden and displayed as -1.
symbolstringquery_futures_usds_insurance_fund_balance_snapshotQuery Insurance Fund Balance Snapshot
symbolstringSymbol
query_portfolio_margin_asset_index_priceQuery Portfolio Margin Asset Index Price
Weight:
asset is sentasset is not sentassetstringquery_spot_execution_rulesQuery execution rules for symbols.
Weight: Parameter | Weight
|
symbol | 2 symbols | 2 for each symbol, capped at a max of 40 symbolStatus | 40 None | 40
symbolstringQuery for specified symbol.
symbolsarrayQuery for multiple symbols.
symbolStatusstringQuery for all symbols with the specified status.
TRADINGHALTBREAKquery_spot_reference_priceQuery the reference price for a symbol.
symbolstringquery_spot_reference_price_calculationDescribes how reference price is calculated for a given symbol.
symbolstringsymbolStatusstringSupported values: `TRADING`, `HALT`, `BREAK`
TRADINGHALTBREAKtoken_quoteGet AI-generated analysis and insights for a specific token, including TLDR summary, opportunities, risks, and community sentiment. Only use this when users explicitly ask for token analysis, AI insights, token summary, or in-depth overview — NOT for simple price checks. For basic price queries, use the ticker tools instead.
langstringensymbolstringBNB