# Upbit

> Read Upbit's public market data: the price and day's change of any Korean won, bitcoin or tether market or all of them at once, price candles from 1 second to 1 year, recent trades, the order book, price steps, and the markets Upbit lists with their Korean and English names and warning flags. Start a workflow when a price crosses a level or a new market is listed. No account or API key required.

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

## Actions

### Get order book

Get the best buy and sell orders waiting on an Upbit market, up to 30 prices a side, with the best bid and ask, the spread and the mid price. A won market's orders can be grouped by a price level, such as every 100,000 KRW.

**Inputs**

- Market (`market`, text, required): The market, such as BTC/KRW for bitcoin in Korean won. A market from an earlier step works too, written as KRW-BTC, BTC/KRW, or BTC alone for its won market.
- Prices per side (`depth`, number): How many prices to list on each side, from 1 to 30. From 1 to 30. Default: `15`.
- Group prices by (`level`, text): Add up the orders within each step of this size, such as 100000 for every 100,000 KRW. Only won markets can be grouped. Leave blank for each price on its own.

**Outputs**

- `asks` (list): The sell orders, lowest price first.
- `base_currency` (text): The coin traded, such as BTC.
- `best_ask` (number): The lowest price a seller is asking.
- `best_bid` (number): The highest price a buyer is offering.
- `bids` (list): The buy orders, highest price first.
- `depth` (number): How many prices came back on each side.
- `level` (number): The price the orders are grouped by, or 0 when they are not grouped.
- `market` (text): Upbit's code for the market, quote currency first: KRW-BTC.
- `mid_price` (number): Halfway between the best bid and the best ask.
- `pair` (text): The market as people write it, coin first: BTC/KRW.
- `quote_currency` (text): The currency it is priced in: KRW, BTC or USDT.
- `spread` (number): The best ask minus the best bid.
- `spread_percent` (number): The spread as a percentage of the mid price.
- `summary` (text): One line with the best bid and ask.
- `time` (text): When Upbit read the order book, in ISO 8601 (UTC).
- `time_kst` (text): The same time in Korea time (UTC+9).
- `total_ask_size` (number): How much of the coin the listed asks add up to.
- `total_bid_size` (number): How much of the coin the listed bids add up to.

**Example output**

```json
{
  "asks": [
    {
      "price": 103900000.0,
      "price_text": "103,900,000 KRW",
      "size": 0.08418788,
      "value": 8747120.732
    },
    {
      "price": 104000000.0,
      "price_text": "104,000,000 KRW",
      "size": 0.67725007,
      "value": 70434007.28
    },
    {
      "price": 104100000.0,
      "price_text": "104,100,000 KRW",
      "size": 1.57941279,
      "value": 164416871.43899998
    }
  ],
  "base_currency": "BTC",
  "best_ask": 103900000.0,
  "best_bid": 103800000.0,
  "bids": [
    {
      "price": 103800000.0,
      "price_text": "103,800,000 KRW",
      "size": 0.40570397,
      "value": 42112072.086
    },
    {
      "price": 103700000.0,
      "price_text": "103,700,000 KRW",
      "size": 3.17829877,
      "value": 329589582.449
    },
    {
      "price": 103600000.0,
      "price_text": "103,600,000 KRW",
      "size": 5.34209737,
      "value": 553441287.5320001
    }
  ],
  "depth": 3,
  "level": 100000.0,
  "market": "KRW-BTC",
  "mid_price": 103850000.0,
  "pair": "BTC/KRW",
  "quote_currency": "KRW",
  "spread": 100000.0,
  "spread_percent": 0.0963,
  "summary": "BTC/KRW: best bid 103,800,000 KRW, best ask 103,900,000 KRW, 3 levels a side, grouped by 100,000 KRW.",
  "time": "2026-11-02T19:56:44Z",
  "time_kst": "2026-11-03T04:56:44+09:00",
  "total_ask_size": 40.35367119,
  "total_bid_size": 228.33175755
}
```

### Get price candles

Get an Upbit market's price candles (open, high, low, close, volume and value) of 1 second to 1 year each, the latest or those before a time, newest first, with the change across them.

**Inputs**

- Market (`market`, text, required): The market, such as BTC/KRW for bitcoin in Korean won. A market from an earlier step works too, written as KRW-BTC, BTC/KRW, or BTC alone for its won market.
- Candle length (`interval`, text): How long each candle is. 1 second candles go back 3 months only. One of: `second` (1 second), `minute` (1 minute), `3_minutes` (3 minutes), `5_minutes` (5 minutes), `10_minutes` (10 minutes), `15_minutes` (15 minutes), `30_minutes` (30 minutes), `hour` (1 hour), `4_hours` (4 hours), `day` (1 day), and 3 more. Default: `day`.
- Number of candles (`count`, number): How many candles, from 1 to 200. From 1 to 200. Default: `30`.
- Before (`before`, date and time): Only candles before this time. Leave blank for the latest.
- Also in Korean won (`convert_to_krw`, true/false): For a bitcoin or tether market, add each day's close converted to won. Only when Candle length is 1 day. Default: `false`.

**Outputs**

- `base_currency` (text): The coin traded, such as BTC.
- `candles` (list): The candles, newest first. A period with no trades has no candle.
- `change_percent` (number): The change from the oldest candle's open to the newest one's close, as a percentage.
- `count` (number): How many candles came back.
- `interval` (text): The candle length's key, such as day or 5_minutes.
- `interval_label` (text): The candle length in words, such as 1 day.
- `latest_close` (number): The newest candle's close.
- `market` (text): Upbit's code for the market, quote currency first: KRW-BTC.
- `pair` (text): The market as people write it, coin first: BTC/KRW.
- `quote_currency` (text): The currency it is priced in: KRW, BTC or USDT.
- `summary` (text): One line with the period covered and the latest close.

**Example output**

```json
{
  "base_currency": "ETH",
  "candles": [
    {
      "change_percent": -0.49,
      "close": 0.02908968,
      "close_krw": 3039144.318,
      "high": 0.02910852,
      "last_trade_time": "2026-10-31T23:28:19Z",
      "low": 0.02893908,
      "open": 0.02910851,
      "period_start_date": null,
      "prev_close": 0.02923254,
      "start_time": "2026-10-31T00:00:00Z",
      "start_time_kst": "2026-10-31T09:00:00+09:00",
      "value": 0.30035006,
      "volume": 10.325013
    },
    {
      "change_percent": 1.28,
      "close": 0.02923254,
      "close_krw": 3045036.76164,
      "high": 0.02923254,
      "last_trade_time": "2026-10-30T20:03:03Z",
      "low": 0.0285,
      "open": 0.0288,
      "period_start_date": null,
      "prev_close": 0.02886293,
      "start_time": "2026-10-30T00:00:00Z",
      "start_time_kst": "2026-10-30T09:00:00+09:00",
      "value": 0.94599911,
      "volume": 32.79598163
    },
    {
      "change_percent": -0.25,
      "close": 0.02886293,
      "close_krw": 3040825.12722,
      "high": 0.02999351,
      "last_trade_time": "2026-10-29T22:28:12Z",
      "low": 0.0285,
      "open": 0.02893515,
      "period_start_date": null,
      "prev_close": 0.02893514,
      "start_time": "2026-10-29T00:00:00Z",
      "start_time_kst": "2026-10-29T09:00:00+09:00",
      "value": 1.16211862,
      "volume": 39.95091592
    }
  ],
  "change_percent": 0.53,
  "count": 3,
  "interval": "day",
  "interval_label": "1 day",
  "latest_close": 0.02908968,
  "market": "BTC-ETH",
  "pair": "ETH/BTC",
  "quote_currency": "BTC",
  "summary": "3 ETH/BTC candles of 1 day each, from 2026-10-29T00:00:00Z to 2026-10-31T00:00:00Z; latest close 0.02908968 BTC, +0.53% across them."
}
```

### Get price steps

See the smallest step each Upbit market's prices move in (its tick size), and the price levels its order book can be grouped by.

**Inputs**

- Markets (`markets`, list, required): One market or more, such as BTC/KRW and ETH/KRW. Markets from an earlier step work too, as a list or separated by commas: KRW-BTC, BTC/KRW, or BTC alone for its won market.

**Outputs**

- `count` (number): How many markets came back.
- `markets` (list): Each market's price steps, in the order asked.
- `summary` (text): One line with each market's tick size.

**Example output**

```json
{
  "count": 2,
  "markets": [
    {
      "base_currency": "BTC",
      "market": "KRW-BTC",
      "order_book_levels": [
        10000.0,
        100000.0,
        1000000.0,
        10000000.0,
        100000000.0
      ],
      "pair": "BTC/KRW",
      "quote_currency": "KRW",
      "tick_size": 1000.0,
      "tick_size_text": "1,000 KRW"
    },
    {
      "base_currency": "ETH",
      "market": "BTC-ETH",
      "order_book_levels": [],
      "pair": "ETH/BTC",
      "quote_currency": "BTC",
      "tick_size": 1e-08,
      "tick_size_text": "0.00000001 BTC"
    }
  ],
  "summary": "BTC/KRW moves in steps of 1,000 KRW; ETH/BTC moves in steps of 0.00000001 BTC"
}
```

### Get prices

Get the last price of one Upbit market or several, with the day so far: the change since the previous close (Upbit's day starts at 9am Korea time), open, high, low, volume and value, the last 24 hours' volume and value, and the 52 week high and low.

**Inputs**

- Markets (`markets`, list, required): One market or more, such as BTC/KRW and ETH/KRW. Markets from an earlier step work too, as a list or separated by commas: KRW-BTC, BTC/KRW, or BTC alone for its won market.

**Outputs**

- `count` (number): How many markets' prices came back.
- `summary` (text): Each market's price and change, on one line.
- `tickers` (list): Each market's price, in the order asked.

**Example output**

```json
{
  "count": 2,
  "summary": "BTC/KRW (Bitcoin): 103,811,000 KRW, -0.99% since 9am Korea time; ETH/KRW (Ethereum): 3,036,000 KRW, -0.30% since 9am Korea time",
  "tickers": [
    {
      "base_currency": "BTC",
      "caution_reasons": [
        "Deposit surge"
      ],
      "change": "fall",
      "change_percent": -0.99,
      "change_price": -1039000.0,
      "english_name": "Bitcoin",
      "high_price": 106106000.0,
      "highest_52_week_date": "2025-11-04",
      "highest_52_week_price": 161128000.0,
      "korean_name": "\ube44\ud2b8\ucf54\uc778",
      "low_price": 103582000.0,
      "lowest_52_week_date": "2026-08-14",
      "lowest_52_week_price": 88342000.0,
      "market": "KRW-BTC",
      "opening_price": 104850000.0,
      "pair": "BTC/KRW",
      "prev_closing_price": 104850000.0,
      "price": 103811000.0,
      "price_text": "103,811,000 KRW",
      "quote_currency": "KRW",
      "summary": "BTC/KRW (Bitcoin): 103,811,000 KRW, -0.99% since 9am Korea time",
      "trade_time": "2026-11-02T19:56:22Z",
      "trade_time_kst": "2026-11-03T04:56:22+09:00",
      "value_24h": 64331946108.89394,
      "value_today": 57500126425.16359,
      "volume_24h": 613.45591312,
      "volume_today": 547.99592594,
      "warning": false
    },
    {
      "base_currency": "ETH",
      "caution_reasons": [],
      "change": "fall",
      "change_percent": -0.3,
      "change_price": -9000.0,
      "english_name": "Ethereum",
      "high_price": 3120000.0,
      "highest_52_week_date": "2025-11-04",
      "highest_52_week_price": 5485000.0,
      "korean_name": "\uc774\ub354\ub9ac\uc6c0",
      "low_price": 3020000.0,
      "lowest_52_week_date": "2026-06-06",
      "lowest_52_week_price": 2300000.0,
      "market": "KRW-ETH",
      "opening_price": 3047000.0,
      "pair": "ETH/KRW",
      "prev_closing_price": 3045000.0,
      "price": 3036000.0,
      "price_text": "3,036,000 KRW",
      "quote_currency": "KRW",
      "summary": "ETH/KRW (Ethereum): 3,036,000 KRW, -0.30% since 9am Korea time",
      "trade_time": "2026-11-02T19:56:34Z",
      "trade_time_kst": "2026-11-03T04:56:34+09:00",
      "value_24h": 37417787370.59371,
      "value_today": 33793292143.61087,
      "volume_24h": 12181.69487404,
      "volume_today": 10985.58801269,
      "warning": false
    }
  ]
}
```

### List all prices

Get the price and day's change of every coin Upbit trades in Korean won, bitcoin or tether in one step, sorted by trading value, biggest rise or biggest fall, to find the day's movers.

**Inputs**

- Quote currencies (`quote_currencies`, list, required): Which markets to list: those priced in Korean won, in bitcoin, in tether, or several. One or more of: `KRW` (KRW (Korean won)), `BTC` (BTC (bitcoin)), `USDT` (USDT (tether)).
- Sort by (`sort_by`, text): How to order each quote currency's markets. Defaults to the most traded over 24 hours first. One of: `value_24h` (Most traded over 24 hours), `rise` (Biggest rise today), `fall` (Biggest fall today), `name` (By name). Default: `value_24h`.
- Markets per quote currency (`limit`, number): How many markets to list for each quote currency, such as 10 for the top 10. Leave blank for all of them. From 1 to 500.

**Outputs**

- `count` (number): How many markets are listed.
- `quote_currencies` (list): The quote currencies listed: KRW, BTC, USDT.
- `sort_by` (text): How the list is sorted: value_24h, rise, fall or name.
- `summary` (text): One line saying what is listed and how it is sorted.
- `tickers` (list): Each market's price, grouped by quote currency in the order chosen, sorted within each.
- `total` (number): How many markets those quote currencies have.

**Example output**

```json
{
  "count": 3,
  "quote_currencies": [
    "USDT"
  ],
  "sort_by": "value_24h",
  "summary": "3 of 3 Upbit markets in USDT, by trading value over 24 hours.",
  "tickers": [
    {
      "base_currency": "BTC",
      "caution_reasons": [
        "Deposit surge"
      ],
      "change": "fall",
      "change_percent": -1.7,
      "change_price": -1331.14,
      "english_name": "Bitcoin",
      "high_price": 78888.22,
      "highest_52_week_date": "2025-11-04",
      "highest_52_week_price": 107730.27,
      "korean_name": "\ube44\ud2b8\ucf54\uc778",
      "low_price": 76874.68,
      "lowest_52_week_date": "2026-07-01",
      "lowest_52_week_price": 58010.01,
      "market": "USDT-BTC",
      "opening_price": 78222.6,
      "pair": "BTC/USDT",
      "prev_closing_price": 78222.6,
      "price": 76891.46,
      "price_text": "76,891.46 USDT",
      "quote_currency": "USDT",
      "summary": "BTC/USDT (Bitcoin): 76,891.46 USDT, -1.70% since 9am Korea time",
      "trade_time": "2026-11-02T19:56:07Z",
      "trade_time_kst": "2026-11-03T04:56:07+09:00",
      "value_24h": 349105.26961288,
      "value_today": 309486.0754027958,
      "volume_24h": 4.47422949,
      "volume_today": 3.96670926,
      "warning": false
    },
    {
      "base_currency": "ETH",
      "caution_reasons": [],
      "change": "fall",
      "change_percent": -1.55,
      "change_price": -35.33,
      "english_name": "Ethereum",
      "high_price": 2311.96,
      "highest_52_week_date": "2025-11-09",
      "highest_52_week_price": 3688.82,
      "korean_name": "\uc774\ub354\ub9ac\uc6c0",
      "low_price": 2239.0,
      "lowest_52_week_date": "2026-06-06",
      "lowest_52_week_price": 1500.0,
      "market": "USDT-ETH",
      "opening_price": 2275.65,
      "pair": "ETH/USDT",
      "prev_closing_price": 2274.33,
      "price": 2239.0,
      "price_text": "2,239 USDT",
      "quote_currency": "USDT",
      "summary": "ETH/USDT (Ethereum): 2,239 USDT, -1.55% since 9am Korea time",
      "trade_time": "2026-11-02T19:48:31Z",
      "trade_time_kst": "2026-11-03T04:48:31+09:00",
      "value_24h": 158278.74559132,
      "value_today": 145398.5944018606,
      "volume_24h": 69.46388142,
      "volume_today": 63.77301645,
      "warning": false
    },
    {
      "base_currency": "SOL",
      "caution_reasons": [],
      "change": "fall",
      "change_percent": -2.48,
      "change_price": -2.31,
      "english_name": "Solana",
      "high_price": 97.05,
      "highest_52_week_date": "2025-11-04",
      "highest_52_week_price": 172.0,
      "korean_name": "\uc194\ub77c\ub098",
      "low_price": 91.0,
      "lowest_52_week_date": "2026-06-06",
      "lowest_52_week_price": 60.98,
      "market": "USDT-SOL",
      "opening_price": 94.04,
      "pair": "SOL/USDT",
      "prev_closing_price": 93.31,
      "price": 91.0,
      "price_text": "91 USDT",
      "quote_currency": "USDT",
      "summary": "SOL/USDT (Solana): 91 USDT, -2.48% since 9am Korea time",
      "trade_time": "2026-11-02T19:47:28Z",
      "trade_time_kst": "2026-11-03T04:47:28+09:00",
      "value_24h": 18388.30915547,
      "value_today": 17926.4611200602,
      "volume_24h": 196.20137785,
      "volume_today": 191.26102933,
      "warning": false
    }
  ],
  "total": 3
}
```

### List markets

List the markets Upbit trades, in Korean won, bitcoin and tether, with each coin's Korean and English names and whether Upbit has put it under an investment warning or a caution, and why. Filter by quote currency, name or flag.

**Inputs**

- Quote currency (`quote_currency`, text): Only markets priced in this currency. Leave blank for all three. One of: `KRW` (KRW (Korean won)), `BTC` (BTC (bitcoin)), `USDT` (USDT (tether)).
- Name contains (`search`, text): Only markets whose code or coin name (English or Korean) contains this text, such as bitcoin or 비트코인.
- Only flagged markets (`flagged_only`, true/false): Only markets under an investment warning or a caution. Default: `false`.

**Outputs**

- `caution_count` (number): How many listed markets are under a caution.
- `count` (number): How many markets matched and are listed.
- `markets` (list): The matching markets: won markets first, then bitcoin, then tether, each by coin.
- `summary` (text): One line saying how many markets matched.
- `total` (number): How many markets Upbit lists in all.
- `warning_count` (number): How many listed markets are under a warning.

**Example output**

```json
{
  "caution_count": 1,
  "count": 2,
  "markets": [
    {
      "base_currency": "BCH",
      "caution": false,
      "caution_reasons": [],
      "english_name": "Bitcoin Cash",
      "korean_name": "\ube44\ud2b8\ucf54\uc778\uce90\uc2dc",
      "market": "KRW-BCH",
      "pair": "BCH/KRW",
      "quote_currency": "KRW",
      "url": "https://upbit.com/exchange?code=CRIX.UPBIT.KRW-BCH",
      "warning": false
    },
    {
      "base_currency": "BTC",
      "caution": true,
      "caution_reasons": [
        "Deposit surge"
      ],
      "english_name": "Bitcoin",
      "korean_name": "\ube44\ud2b8\ucf54\uc778",
      "market": "KRW-BTC",
      "pair": "BTC/KRW",
      "quote_currency": "KRW",
      "url": "https://upbit.com/exchange?code=CRIX.UPBIT.KRW-BTC",
      "warning": false
    }
  ],
  "summary": "2 of Upbit's 8 markets match; 0 under an investment warning and 1 under a caution.",
  "total": 8,
  "warning_count": 0
}
```

### List recent trades

List an Upbit market's trades on one day of the last 7 (days start at midnight UTC), newest first, optionally before a time of day, with each trade's price, amount and side and the total bought and sold. Page back with Continue from.

**Inputs**

- Market (`market`, text, required): The market, such as BTC/KRW for bitcoin in Korean won. A market from an earlier step works too, written as KRW-BTC, BTC/KRW, or BTC alone for its won market.
- Number of trades (`count`, number): How many trades, from 1 to 500. From 1 to 500. Default: `50`.
- Day (`days_ago`, text): Which day's trades: today or up to 7 days back, by UTC date. One of: `0` (Today (UTC)), `1` (Yesterday), `2` (2 days ago), `3` (3 days ago), `4` (4 days ago), `5` (5 days ago), `6` (6 days ago), `7` (7 days ago). Default: `0`.
- Before (UTC) (`before_time`, time): Only trades made before this time of day, in UTC. Leave blank for the latest of the day.
- Continue from (`cursor`, text): To list earlier trades, the Next page value of an earlier List recent trades on the same market and day.

**Outputs**

- `average_price` (number): The average price, weighted by volume.
- `base_currency` (text): The coin traded, such as BTC.
- `buy_volume` (number): How much of it was bought.
- `count` (number): How many trades came back.
- `has_more` (true/false): True when there may be earlier trades that day.
- `market` (text): Upbit's code for the market, quote currency first: KRW-BTC.
- `next_cursor` (text): Put this in Continue from to list the trades before these. Empty when there are no more.
- `pair` (text): The market as people write it, coin first: BTC/KRW.
- `quote_currency` (text): The currency it is priced in: KRW, BTC or USDT.
- `sell_volume` (number): How much of it was sold.
- `summary` (text): One line with the period covered and its volume.
- `total_value` (number): What they were worth in the quote currency.
- `total_volume` (number): How much of the coin those trades moved.
- `trades` (list): The trades, newest first.

**Example output**

```json
{
  "average_price": 104179356.56068462,
  "base_currency": "BTC",
  "buy_volume": 0,
  "count": 3,
  "has_more": true,
  "market": "KRW-BTC",
  "next_cursor": "17935379953750000",
  "pair": "BTC/KRW",
  "quote_currency": "KRW",
  "sell_volume": 0.01564951,
  "summary": "3 BTC/KRW trades from 2026-11-01T12:59:55Z to 2026-11-01T12:59:55Z: 0.01564951 BTC worth 1,630,356 KRW.",
  "total_value": 1630355.88229,
  "total_volume": 0.01564951,
  "trades": [
    {
      "price": 104179000.0,
      "side": "sell",
      "time": "2026-11-01T12:59:55Z",
      "time_kst": "2026-11-01T21:59:55+09:00",
      "trade_id": "17935379953750002",
      "value": 49999.66926,
      "volume": 0.00047994
    },
    {
      "price": 104179000.0,
      "side": "sell",
      "time": "2026-11-01T12:59:55Z",
      "time_kst": "2026-11-01T21:59:55+09:00",
      "trade_id": "17935379953750001",
      "value": 1561598.41303,
      "volume": 0.01498957
    },
    {
      "price": 104210000.0,
      "side": "sell",
      "time": "2026-11-01T12:59:55Z",
      "time_kst": "2026-11-01T21:59:55+09:00",
      "trade_id": "17935379953750000",
      "value": 18757.8,
      "volume": 0.00018
    }
  ]
}
```
