# Binance

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

App · 6 actions. Web page: https://docs.lodol.com/docs/integrations/binance

## Actions

### 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**

- Market (`symbol`, text, required): 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_price` (number): The lowest price a seller is currently asking.
- `ask_quantity` (number): How much of the base asset is offered at the ask price.
- `bid_price` (number): The highest price a buyer is currently offering.
- `bid_quantity` (number): How much of the base asset is wanted at the bid price.
- `close_time` (text): When the 24-hour window closed (ISO 8601, UTC).
- `high_price` (number): The highest price traded in the last 24 hours.
- `last_price` (number): The price of the most recent trade, in the quote asset.
- `last_quantity` (number): The size of the most recent trade, in the base asset.
- `low_price` (number): The lowest price traded in the last 24 hours.
- `open_price` (number): The price 24 hours ago.
- `open_time` (text): When the 24-hour window opened (ISO 8601, UTC).
- `previous_close_price` (number): The price of the last trade before the 24-hour window opened.
- `price_change` (number): How far the price has moved over the last 24 hours, in the quote asset.
- `price_change_percent` (number): The 24-hour price move as a percentage, e.g. -0.959 for a 0.959% fall.
- `quote_volume` (number): The value traded in the last 24 hours, in the quote asset.
- `spread` (number): The ask price minus the bid price.
- `summary` (text): 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)'.
- `symbol` (text): The market, e.g. 'BTCUSDT'.
- `trade_count` (number): How many trades happened in the last 24 hours.
- `volume` (number): How much of the base asset traded in the last 24 hours.
- `weighted_average_price` (number): The volume-weighted average price over the last 24 hours.

**Example output**

```json
{
  "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**

- Market (`symbol`, text, required): 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_asset` (text): The asset being bought and sold, e.g. 'BTC'.
- `base_asset_precision` (number): How many decimal places the base asset is counted to.
- `is_trading` (true/false): True when the market is open for trading.
- `margin_trading_allowed` (true/false): True when the market can be traded on margin.
- `max_notional` (number): The largest order value, in the quote asset.
- `max_price` (number): The highest price an order may carry.
- `max_quantity` (number): The largest order, in the base asset.
- `min_notional` (number): The smallest order value, in the quote asset.
- `min_price` (number): The lowest price an order may carry.
- `min_quantity` (number): The smallest order, in the base asset.
- `order_types` (list): The order types the market accepts, e.g. 'LIMIT', 'MARKET'.
- `quote_asset` (text): The asset prices are quoted in, e.g. 'USDT'.
- `quote_asset_precision` (number): How many decimal places the quote asset is counted to.
- `spot_trading_allowed` (true/false): True when the market can be traded on Binance's spot exchange.
- `status` (text): Binance's status for the market, e.g. 'TRADING' or 'BREAK'.
- `step_size` (number): The smallest step an order's quantity can move in.
- `summary` (text): 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'.
- `symbol` (text): The market, e.g. 'BTCUSDT'.
- `tick_size` (number): The smallest step a price can move in.

**Example output**

```json
{
  "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**

- Market (`symbol`, text, required): 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 side (`depth`, number): 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_total` (number): The base asset offered across all the ask levels returned.
- `asks` (list): Sell orders, lowest price first.
- `best_ask` (number): The lowest price a seller is asking.
- `best_bid` (number): The highest price a buyer is offering.
- `bid_quantity_total` (number): The base asset wanted across all the bid levels returned.
- `bids` (list): Buy orders, highest price first.
- `last_update_id` (number): Binance's sequence number for this snapshot of the book.
- `mid_price` (number): Halfway between the best bid and the best ask.
- `spread` (number): The best ask minus the best bid.
- `spread_percent` (number): The spread as a percentage of the mid price.
- `symbol` (text): The market, e.g. 'BTCUSDT'.

**Example output**

```json
{
  "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**

- Market (`symbol`, text, required): 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 size (`interval`, text): 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 candles (`limit`, number): How many candles to return, from 1 to 1000. Defaults to 30. From 1 to 1000. Default: `30`.
- From (`start_time`, date and time): Only candles that open at or after this time. Leave blank for the most recent candles.
- Until (`end_time`, date and time): Only candles that open at or before this time.

**Outputs**

- `candles` (list): The candles, oldest first.
- `change_percent` (number): The move from the first candle's open to the last candle's close, as a percentage.
- `count` (number): How many candles came back.
- `first_open` (number): The opening price of the first candle.
- `interval` (text): The length of each candle, e.g. '1d' or '1h'.
- `last_close` (number): The closing (or latest) price of the last candle.
- `period_high` (number): The highest price across all the candles.
- `period_low` (number): The lowest price across all the candles.
- `symbol` (text): The market, e.g. 'BTCUSDT'.

**Example output**

```json
{
  "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**

- Markets (`symbols`, list, required): The markets to price, as a list or separated by commas, e.g. BTCUSDT, ETHUSDT. Up to 100.

**Outputs**

- `count` (number): How many prices came back.
- `prices` (list): One price per market, in the order asked for.

**Example output**

```json
{
  "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**

- Market (`symbol`, text, required): 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 trades (`limit`, number): How many trades to return, from 1 to 1000. Defaults to 20. From 1 to 1000. Default: `20`.

**Outputs**

- `count` (number): How many trades came back.
- `symbol` (text): The market, e.g. 'BTCUSDT'.
- `trades` (list): The trades, newest first.

**Example output**

```json
{
  "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"
    }
  ]
}
```