# KuCoin

> Read live market data from KuCoin, the global crypto exchange: 24-hour tickers for one market or all of them, price history candles, order books, recent trades, crypto prices in fiat currencies and each currency's deposit and withdrawal networks. Read-only, so it can never place an order. No account or API key required.

App · 7 actions. Web page: https://docs.lodol.com/docs/integrations/kucoin

## Actions

### Get 24-hour ticker

Get a KuCoin market's latest price and its last 24 hours: the change, high, low, average price and volume, plus the current best bid and ask. No API key required.

**Inputs**

- Market (`symbol`, text, required): The KuCoin market: the base currency, a hyphen, then the quote currency, e.g. BTC-USDT for bitcoin priced in Tether. 'BTC/USDT' works too.

**Outputs**

- `ask_price` (number): The lowest price a seller is currently asking.
- `average_price` (number): KuCoin's average trading price over the last 24 hours.
- `base_currency` (text): The currency being bought and sold, e.g. 'BTC'.
- `bid_price` (number): The highest price a buyer is currently offering.
- `high_price` (number): The highest price in the last 24 hours.
- `last_price` (number): The price of the most recent trade.
- `low_price` (number): The lowest price in the last 24 hours.
- `maker_fee_rate` (number): KuCoin's basic maker fee for the market, as a fraction (0.001 is 0.1%).
- `price_change` (number): How far the price has moved over the last 24 hours.
- `price_change_percent` (number): The 24-hour price move as a percentage, e.g. -1.44 for a 1.44% fall.
- `quote_currency` (text): The currency prices are quoted in, e.g. 'USDT'.
- `quote_volume` (number): The value traded in the last 24 hours, in the quote currency.
- `spread` (number): The ask price minus the bid price.
- `summary` (text): One line about the market, e.g. 'BTC/USDT is at 81,127 on KuCoin, down 1.44% over 24 hours (high 82,913.2, low 80,814.7)'.
- `symbol` (text): The market, e.g. 'BTC-USDT'.
- `taker_fee_rate` (number): KuCoin's basic taker fee for the market, as a fraction (0.001 is 0.1%).
- `time` (text): When KuCoin produced these figures (ISO 8601, UTC).
- `volume` (number): How much of the base currency traded in the last 24 hours.

**Example output**

```json
{
  "ask_price": 81127.0,
  "average_price": 82191.64985123,
  "base_currency": "BTC",
  "bid_price": 81126.9,
  "high_price": 82913.2,
  "last_price": 81127.0,
  "low_price": 80814.7,
  "maker_fee_rate": 0.001,
  "price_change": -1185.4,
  "price_change_percent": -1.44,
  "quote_currency": "USDT",
  "quote_volume": 441127565.87811077,
  "spread": 0.1,
  "summary": "BTC/USDT is at 81,127 on KuCoin, down 1.44% over 24 hours (high 82,913.2, low 80,814.7)",
  "symbol": "BTC-USDT",
  "taker_fee_rate": 0.001,
  "time": "2026-10-16T18:48:06.258Z",
  "volume": 5375.481124397454
}
```

### Get currency

Get a currency's details at KuCoin and every network it can be deposited or withdrawn on, with each network's minimums, withdrawal fee, confirmations and contract address. No API key required.

**Inputs**

- Currency (`currency`, text, required): The currency code, e.g. BTC, USDT or ETH.

**Outputs**

- `chain_count` (number): How many networks KuCoin moves it on.
- `chains` (list): The networks KuCoin deposits and withdraws it on.
- `currency` (text): The currency code, e.g. 'BTC'.
- `margin_enabled` (true/false): True when it can be used for margin trading.
- `name` (text): The currency's full name, e.g. 'Bitcoin'.
- `precision` (number): How many decimal places KuCoin counts it to.
- `summary` (text): One line about the currency, e.g. 'Bitcoin (BTC) moves on 2 networks at KuCoin: BTC, BEP20'.

**Example output**

```json
{
  "chain_count": 2,
  "chains": [
    {
      "chain_id": "btc",
      "confirmations": 3,
      "contract_address": null,
      "deposit_enabled": true,
      "deposit_minimum": 3e-05,
      "name": "BTC",
      "needs_memo": false,
      "withdraw_enabled": true,
      "withdraw_fee": 9e-05,
      "withdraw_minimum": 0.00018
    },
    {
      "chain_id": "bsc",
      "confirmations": 60,
      "contract_address": "0x7130d2a12b9bcbfae4f2634d864a1ee1ce3ead9c",
      "deposit_enabled": true,
      "deposit_minimum": 1e-07,
      "name": "BEP20",
      "needs_memo": false,
      "withdraw_enabled": true,
      "withdraw_fee": 4e-06,
      "withdraw_minimum": 8e-06
    }
  ],
  "currency": "BTC",
  "margin_enabled": true,
  "name": "Bitcoin",
  "precision": 8,
  "summary": "Bitcoin (BTC) moves on 2 networks at KuCoin: BTC, BEP20"
}
```

### Get fiat prices

Get what cryptocurrencies are worth in a fiat currency, e.g. BTC and ETH in US dollars or euros, by KuCoin's own prices. Up to 100 currencies at once. No API key required.

**Inputs**

- Cryptocurrencies (`currencies`, list, required): The currencies to price, as a list or separated by commas, e.g. BTC, ETH, SOL.
- Fiat currency (`fiat`, text): The currency to price them in. Defaults to USD. Default: `USD`.

**Outputs**

- `count` (number): How many prices came back.
- `fiat` (text): The fiat currency the prices are in, e.g. 'USD'.
- `not_found` (list): Currencies KuCoin had no price for.
- `prices` (list): One price per currency found, in the order asked for.

**Example output**

```json
{
  "count": 2,
  "fiat": "USD",
  "not_found": [],
  "prices": [
    {
      "currency": "BTC",
      "price": 81005.30950019092
    },
    {
      "currency": "ETH",
      "price": 2403.169829999724
    }
  ]
}
```

### Get order book

Get the best 20 or 100 buy and sell orders on a KuCoin market, best prices first, with the spread and the mid price. No API key required.

**Inputs**

- Market (`symbol`, text, required): The KuCoin market: the base currency, a hyphen, then the quote currency, e.g. BTC-USDT for bitcoin priced in Tether. 'BTC/USDT' works too.
- Levels per side (`depth`, text): How many price levels to return on each side: 20 or 100. Defaults to 20. One of: `20` (20 levels), `100` (100 levels). Default: `20`.

**Outputs**

- `ask_quantity_total` (number): The base currency 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 currency wanted across all the bid levels returned.
- `bids` (list): Buy orders, highest price first.
- `mid_price` (number): Halfway between the best bid and the best ask.
- `sequence` (number): KuCoin's sequence number for this snapshot.
- `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. 'BTC-USDT'.
- `time` (text): When KuCoin took this snapshot of the book (ISO 8601, UTC).

**Example output**

```json
{
  "ask_quantity_total": 0.02915952,
  "asks": [
    {
      "price": 81127.0,
      "quantity": 0.01665952
    },
    {
      "price": 81127.2,
      "quantity": 0.005
    },
    {
      "price": 81127.3,
      "quantity": 0.0075
    }
  ],
  "best_ask": 81127.0,
  "best_bid": 81126.9,
  "bid_quantity_total": 1.31600206,
  "bids": [
    {
      "price": 81126.9,
      "quantity": 1.30316035
    },
    {
      "price": 81125.9,
      "quantity": 0.0005
    },
    {
      "price": 81125.7,
      "quantity": 0.01234171
    }
  ],
  "mid_price": 81126.95,
  "sequence": 38790751512,
  "spread": 0.1,
  "spread_percent": 0.000123,
  "symbol": "BTC-USDT",
  "time": "2026-10-16T18:48:09.181Z"
}
```

### Get price history

Get candles (open, high, low, close and volume) for a KuCoin 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 KuCoin market: the base currency, a hyphen, then the quote currency, e.g. BTC-USDT for bitcoin priced in Tether. 'BTC/USDT' works too.
- Candle size (`interval`, text): How long each candle covers. Defaults to one day. One of: `1min` (1 minute), `5min` (5 minutes), `15min` (15 minutes), `30min` (30 minutes), `1hour` (1 hour), `4hour` (4 hours), `12hour` (12 hours), `1day` (1 day), `1week` (1 week), `1month` (1 month). Default: `1day`.
- Number of candles (`limit`, number): How many of the most recent candles to return, from 1 to 1500. Defaults to 30. From 1 to 1500. 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 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. '1day' or '1hour'.
- `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. 'BTC-USDT'.

**Example output**

```json
{
  "candles": [
    {
      "close": 83172.7,
      "close_time": "2026-10-13T23:59:59.999Z",
      "high": 84149.0,
      "is_closed": true,
      "low": 81035.5,
      "open": 81858.5,
      "open_time": "2026-10-13T00:00:00.000Z",
      "quote_volume": 216986769.23053944,
      "volume": 2610.381771960947
    },
    {
      "close": 81679.7,
      "close_time": "2026-10-14T23:59:59.999Z",
      "high": 84126.6,
      "is_closed": true,
      "low": 81458.9,
      "open": 83172.8,
      "open_time": "2026-10-14T00:00:00.000Z",
      "quote_volume": 243753399.5024408,
      "volume": 2946.977255460671
    },
    {
      "close": 82241.7,
      "close_time": "2026-10-15T23:59:59.999Z",
      "high": 82626.9,
      "is_closed": true,
      "low": 79800.9,
      "open": 81679.8,
      "open_time": "2026-10-15T00:00:00.000Z",
      "quote_volume": 266305274.8382482,
      "volume": 3269.2533390887265
    }
  ],
  "change_percent": 0.4681,
  "count": 3,
  "first_open": 81858.5,
  "interval": "1day",
  "last_close": 82241.7,
  "period_high": 84149.0,
  "period_low": 79800.9,
  "symbol": "BTC-USDT"
}
```

### List recent trades

List the latest trades on a KuCoin market, newest first, with each trade's price, size, value and side. No API key required.

**Inputs**

- Market (`symbol`, text, required): The KuCoin market: the base currency, a hyphen, then the quote currency, e.g. BTC-USDT for bitcoin priced in Tether. 'BTC/USDT' works too.
- Number of trades (`limit`, number): How many trades to return, from 1 to 100. Defaults to 20. From 1 to 100. Default: `20`.

**Outputs**

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

**Example output**

```json
{
  "count": 2,
  "symbol": "BTC-USDT",
  "trades": [
    {
      "id": "24850158124679191",
      "price": 81127.0,
      "quantity": 0.0033599,
      "quote_quantity": 272.5786073,
      "side": "buy",
      "time": "2026-10-16T18:48:05.312Z"
    },
    {
      "id": "24850158124679190",
      "price": 81126.6,
      "quantity": 0.0075,
      "quote_quantity": 608.4495,
      "side": "buy",
      "time": "2026-10-16T18:48:05.312Z"
    }
  ]
}
```

### List tickers

List the 24-hour figures of every market on KuCoin in one step. Narrow it to one quote currency or a coin, and sort by trading volume, by name or by the biggest gainers or losers. No API key required.

**Inputs**

- Quote currency (`quote_currency`, text): Only markets priced in this currency, e.g. USDT, USDC, BTC or ETH. Leave blank for all.
- Coin or market (`search`, text): Only markets whose symbol contains this, e.g. SOL. Leave blank for all.
- Sort by (`sort`, text): How to order the markets. Defaults to the most traded first (by value in the quote currency). One of: `volume` (Most traded), `gainers` (Biggest 24-hour gainers), `losers` (Biggest 24-hour losers), `symbol` (Symbol (A to Z)). Default: `volume`.
- Maximum markets (`limit`, number): The most markets to return, from 1 to 1000. Defaults to 50. From 1 to 1000. Default: `50`.

**Outputs**

- `count` (number): How many markets came back.
- `tickers` (list): The markets, in the order asked for.
- `time` (text): When KuCoin produced these figures (ISO 8601, UTC).
- `total_matches` (number): How many markets matched, before the limit.

**Example output**

```json
{
  "count": 3,
  "tickers": [
    {
      "ask_price": 81127.0,
      "base_currency": "BTC",
      "bid_price": 81126.9,
      "change_percent_24h": -1.44,
      "high_price": 82913.2,
      "last_price": 81127.0,
      "low_price": 80814.7,
      "quote_currency": "USDT",
      "quote_volume": 441147583.97474676,
      "symbol": "BTC-USDT",
      "volume": 5375.727880217453
    },
    {
      "ask_price": 2406.7,
      "base_currency": "ETH",
      "bid_price": 2406.69,
      "change_percent_24h": -1.76,
      "high_price": 2493.31,
      "last_price": 2406.37,
      "low_price": 2393.59,
      "quote_currency": "USDT",
      "quote_volume": 87447982.24440588,
      "symbol": "ETH-USDT",
      "volume": 35743.26574308
    },
    {
      "ask_price": 103.22,
      "base_currency": "SOL",
      "bid_price": 103.21,
      "change_percent_24h": -2.54,
      "high_price": 107.4,
      "last_price": 103.2,
      "low_price": 102.8,
      "quote_currency": "USDT",
      "quote_volume": 21645774.273389164,
      "symbol": "SOL-USDT",
      "volume": 205171.6312927449
    }
  ],
  "time": "2026-10-16T18:48:08.109Z",
  "total_matches": 3
}
```