Binance

App · 6 actions

Read live market data from Binance, the world's largest crypto exchange: 24-hour tickers, prices for up to 100 markets at once, price history candles, order books, recent trades and each market's trading rules. Read-only, so it can never place an order. No account or API key required.

Actions

ActionWhat it does
Get 24-hour tickerGet a Binance market's latest price and its last 24 hours: the price change, high, low, volume and number of trades, plus the current best bid and ask.
Get market infoGet a Binance market's trading rules: whether it is trading, its base and quote assets, the order types it takes, and the smallest order, price step and quantity step.
Get order bookGet the buy and sell orders waiting on a Binance market, best prices first, with the spread and the mid price.
Get price historyGet candles (open, high, low, close and volume) for a Binance market, from 1-minute to 1-month candles, oldest first, with the overall change, high and low across them.
Get pricesGet the latest Binance price of up to 100 markets in one step, e.g. BTCUSDT, ETHUSDT and SOLUSDT.
List recent tradesList the latest trades on a Binance market, newest first, with each trade's price, size, value and whether the taker bought or sold.

Get 24-hour ticker

Get a Binance market's latest price and its last 24 hours: the price change, high, low, volume and number of trades, plus the current best bid and ask. Use it for price alerts or a daily market summary. No API key required.

Inputs

MarketsymboltextRequired
The Binance market: the base asset followed by the quote asset, e.g. BTCUSDT for bitcoin priced in Tether. 'BTC/USDT' and 'btc-usdt' work too.

Outputs

ask_pricenumber
The lowest price a seller is currently asking.
ask_quantitynumber
How much of the base asset is offered at the ask price.
bid_pricenumber
The highest price a buyer is currently offering.
bid_quantitynumber
How much of the base asset is wanted at the bid price.
close_timetext
When the 24-hour window closed (ISO 8601, UTC).
high_pricenumber
The highest price traded in the last 24 hours.
last_pricenumber
The price of the most recent trade, in the quote asset.
last_quantitynumber
The size of the most recent trade, in the base asset.
low_pricenumber
The lowest price traded in the last 24 hours.
open_pricenumber
The price 24 hours ago.
open_timetext
When the 24-hour window opened (ISO 8601, UTC).
previous_close_pricenumber
The price of the last trade before the 24-hour window opened.
price_changenumber
How far the price has moved over the last 24 hours, in the quote asset.
price_change_percentnumber
The 24-hour price move as a percentage, e.g. -0.959 for a 0.959% fall.
quote_volumenumber
The value traded in the last 24 hours, in the quote asset.
spreadnumber
The ask price minus the bid price.
summarytext
One line about the market, e.g. 'BTCUSDT is at 81,408.01, down 0.959% over 24 hours (high 82,940.81, low 80,809.25)'.
symboltext
The market, e.g. 'BTCUSDT'.
trade_countnumber
How many trades happened in the last 24 hours.
volumenumber
How much of the base asset traded in the last 24 hours.
weighted_average_pricenumber
The volume-weighted average price over the last 24 hours.
Example output
{
  "ask_price": 81408.01,
  "ask_quantity": 12.82376,
  "bid_price": 81408.0,
  "bid_quantity": 0.74656,
  "close_time": "2026-10-16T18:30:01.011Z",
  "high_price": 82940.81,
  "last_price": 81408.01,
  "last_quantity": 0.00021,
  "low_price": 80809.25,
  "open_price": 82196.01,
  "open_time": "2026-10-15T18:30:01.011Z",
  "previous_close_price": 82196.0,
  "price_change": -788.0,
  "price_change_percent": -0.959,
  "quote_volume": 1217796078.109794,
  "spread": 0.01,
  "summary": "BTCUSDT is at 81,408.01, down 0.959% over 24 hours (high 82,940.81, low 80,809.25)",
  "symbol": "BTCUSDT",
  "trade_count": 3014381,
  "volume": 14839.70743,
  "weighted_average_price": 82063.34820644
}

Get market info

Get a Binance market's trading rules: whether it is trading, its base and quote assets, the order types it takes, and the smallest order, price step and quantity step. No API key required.

Inputs

MarketsymboltextRequired
The Binance market: the base asset followed by the quote asset, e.g. BTCUSDT for bitcoin priced in Tether. 'BTC/USDT' and 'btc-usdt' work too.

Outputs

base_assettext
The asset being bought and sold, e.g. 'BTC'.
base_asset_precisionnumber
How many decimal places the base asset is counted to.
is_tradingtrue/false
True when the market is open for trading.
margin_trading_allowedtrue/false
True when the market can be traded on margin.
max_notionalnumber
The largest order value, in the quote asset.
max_pricenumber
The highest price an order may carry.
max_quantitynumber
The largest order, in the base asset.
min_notionalnumber
The smallest order value, in the quote asset.
min_pricenumber
The lowest price an order may carry.
min_quantitynumber
The smallest order, in the base asset.
order_typeslist
The order types the market accepts, e.g. 'LIMIT', 'MARKET'.
quote_assettext
The asset prices are quoted in, e.g. 'USDT'.
quote_asset_precisionnumber
How many decimal places the quote asset is counted to.
spot_trading_allowedtrue/false
True when the market can be traded on Binance's spot exchange.
statustext
Binance's status for the market, e.g. 'TRADING' or 'BREAK'.
step_sizenumber
The smallest step an order's quantity can move in.
summarytext
One line about the market's rules, e.g. 'BTC/USDT is trading; orders from 0.00001 BTC in steps of 0.00001, prices in steps of 0.01 USDT'.
symboltext
The market, e.g. 'BTCUSDT'.
tick_sizenumber
The smallest step a price can move in.
Example output
{
  "base_asset": "BTC",
  "base_asset_precision": 8,
  "is_trading": true,
  "margin_trading_allowed": true,
  "max_notional": 9000000.0,
  "max_price": 1000000.0,
  "max_quantity": 9000.0,
  "min_notional": 5.0,
  "min_price": 0.01,
  "min_quantity": 1e-05,
  "order_types": [
    "LIMIT",
    "LIMIT_MAKER",
    "MARKET",
    "STOP_LOSS",
    "STOP_LOSS_LIMIT",
    "TAKE_PROFIT",
    "TAKE_PROFIT_LIMIT"
  ],
  "quote_asset": "USDT",
  "quote_asset_precision": 8,
  "spot_trading_allowed": true,
  "status": "TRADING",
  "step_size": 1e-05,
  "summary": "BTC/USDT is trading; orders from 0.00001 BTC in steps of 0.00001, prices in steps of 0.01 USDT",
  "symbol": "BTCUSDT",
  "tick_size": 0.01
}

Get order book

Get the buy and sell orders waiting on a Binance market, best prices first, with the spread and the mid price. Useful for checking liquidity before a large trade. No API key required.

Inputs

MarketsymboltextRequired
The Binance market: the base asset followed by the quote asset, e.g. BTCUSDT for bitcoin priced in Tether. 'BTC/USDT' and 'btc-usdt' work too.
Levels per sidedepthnumber
How many price levels to return on each side, from 1 to 500. Defaults to 20.From 1 to 500. Default: 20.

Outputs

ask_quantity_totalnumber
The base asset offered across all the ask levels returned.
askslist
Sell orders, lowest price first.
best_asknumber
The lowest price a seller is asking.
best_bidnumber
The highest price a buyer is offering.
bid_quantity_totalnumber
The base asset wanted across all the bid levels returned.
bidslist
Buy orders, highest price first.
last_update_idnumber
Binance's sequence number for this snapshot of the book.
mid_pricenumber
Halfway between the best bid and the best ask.
spreadnumber
The best ask minus the best bid.
spread_percentnumber
The spread as a percentage of the mid price.
symboltext
The market, e.g. 'BTCUSDT'.
Example output
{
  "ask_quantity_total": 12.76558,
  "asks": [
    {
      "price": 81408.01,
      "quantity": 12.76532
    },
    {
      "price": 81408.02,
      "quantity": 0.00013
    },
    {
      "price": 81408.03,
      "quantity": 0.00013
    }
  ],
  "best_ask": 81408.01,
  "best_bid": 81408.0,
  "bid_quantity_total": 0.95511,
  "bids": [
    {
      "price": 81408.0,
      "quantity": 0.95413
    },
    {
      "price": 81407.99,
      "quantity": 0.00076
    },
    {
      "price": 81407.98,
      "quantity": 0.00022
    }
  ],
  "last_update_id": 101545126618,
  "mid_price": 81408.005,
  "spread": 0.01,
  "spread_percent": 1.2e-05,
  "symbol": "BTCUSDT"
}

Get price history

Get candles (open, high, low, close and volume) for a Binance market, from 1-minute to 1-month candles, oldest first, with the overall change, high and low across them. Leave the start and end blank for the most recent candles. No API key required.

Inputs

MarketsymboltextRequired
The Binance market: the base asset followed by the quote asset, e.g. BTCUSDT for bitcoin priced in Tether. 'BTC/USDT' and 'btc-usdt' work too.
Candle sizeintervaltext
How long each candle covers. Defaults to one day.One of: 1m (1 minute), 5m (5 minutes), 15m (15 minutes), 30m (30 minutes), 1h (1 hour), 4h (4 hours), 12h (12 hours), 1d (1 day), 1w (1 week), 1M (1 month). Default: 1d.
Number of candleslimitnumber
How many candles to return, from 1 to 1000. Defaults to 30.From 1 to 1000. Default: 30.
Fromstart_timedate and time
Only candles that open at or after this time. Leave blank for the most recent candles.
Untilend_timedate and time
Only candles that open at or before this time.

Outputs

candleslist
The candles, oldest first.
change_percentnumber
The move from the first candle's open to the last candle's close, as a percentage.
countnumber
How many candles came back.
first_opennumber
The opening price of the first candle.
intervaltext
The length of each candle, e.g. '1d' or '1h'.
last_closenumber
The closing (or latest) price of the last candle.
period_highnumber
The highest price across all the candles.
period_lownumber
The lowest price across all the candles.
symboltext
The market, e.g. 'BTCUSDT'.
Example output
{
  "candles": [
    {
      "close": 81682.01,
      "close_time": "2026-10-14T23:59:59.999Z",
      "high": 84146.72,
      "is_closed": true,
      "low": 81444.42,
      "open": 83169.01,
      "open_time": "2026-10-14T00:00:00.000Z",
      "quote_volume": 1513585768.1108654,
      "taker_buy_quote_volume": 705041794.8140861,
      "taker_buy_volume": 8532.27273,
      "trade_count": 3558844,
      "volume": 18307.57283
    },
    {
      "close": 82245.93,
      "close_time": "2026-10-15T23:59:59.999Z",
      "high": 82634.3,
      "is_closed": true,
      "low": 79800.0,
      "open": 81682.02,
      "open_time": "2026-10-15T00:00:00.000Z",
      "quote_volume": 1836581200.4169843,
      "taker_buy_quote_volume": 858305620.6826396,
      "taker_buy_volume": 10544.51931,
      "trade_count": 4346924,
      "volume": 22563.14627
    },
    {
      "close": 81408.01,
      "close_time": "2026-10-16T23:59:59.999Z",
      "high": 82940.81,
      "is_closed": false,
      "low": 80809.25,
      "open": 82245.93,
      "open_time": "2026-10-16T00:00:00.000Z",
      "quote_volume": 982738353.4549077,
      "taker_buy_quote_volume": 511762158.6807068,
      "taker_buy_volume": 6240.83306,
      "trade_count": 2644855,
      "volume": 11984.90075
    }
  ],
  "change_percent": -2.1174,
  "count": 3,
  "first_open": 83169.01,
  "interval": "1d",
  "last_close": 81408.01,
  "period_high": 84146.72,
  "period_low": 79800.0,
  "symbol": "BTCUSDT"
}

Get prices

Get the latest Binance price of up to 100 markets in one step, e.g. BTCUSDT, ETHUSDT and SOLUSDT. Prices come back in the order the markets were given. No API key required.

Inputs

MarketssymbolslistRequired
The markets to price, as a list or separated by commas, e.g. BTCUSDT, ETHUSDT. Up to 100.

Outputs

countnumber
How many prices came back.
priceslist
One price per market, in the order asked for.
Example output
{
  "count": 2,
  "prices": [
    {
      "price": 81408.01,
      "symbol": "BTCUSDT"
    },
    {
      "price": 2416.81,
      "symbol": "ETHUSDT"
    }
  ]
}

List recent trades

List the latest trades on a Binance market, newest first, with each trade's price, size, value and whether the taker bought or sold. No API key required.

Inputs

MarketsymboltextRequired
The Binance market: the base asset followed by the quote asset, e.g. BTCUSDT for bitcoin priced in Tether. 'BTC/USDT' and 'btc-usdt' work too.
Number of tradeslimitnumber
How many trades to return, from 1 to 1000. Defaults to 20.From 1 to 1000. Default: 20.

Outputs

countnumber
How many trades came back.
symboltext
The market, e.g. 'BTCUSDT'.
tradeslist
The trades, newest first.
Example output
{
  "count": 2,
  "symbol": "BTCUSDT",
  "trades": [
    {
      "id": 6769619260,
      "price": 81408.01,
      "quantity": 2e-05,
      "quote_quantity": 1.6281602,
      "side": "buy",
      "time": "2026-10-16T18:30:05.385Z"
    },
    {
      "id": 6769619259,
      "price": 81408.01,
      "quantity": 7e-05,
      "quote_quantity": 5.6985607,
      "side": "buy",
      "time": "2026-10-16T18:30:05.385Z"
    }
  ]
}

On this page