Upbit

App · 7 actions

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.

Actions

ActionWhat it does
Get order bookGet 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.
Get price candlesGet 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.
Get price stepsSee the smallest step each Upbit market's prices move in (its tick size), and the price levels its order book can be grouped by.
Get pricesGet 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.
List all pricesGet 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.
List marketsList 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.
List recent tradesList 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.

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

MarketmarkettextRequired
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 sidedepthnumber
How many prices to list on each side, from 1 to 30.From 1 to 30. Default: 15.
Group prices byleveltext
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

askslist
The sell orders, lowest price first.
base_currencytext
The coin traded, such as BTC.
best_asknumber
The lowest price a seller is asking.
best_bidnumber
The highest price a buyer is offering.
bidslist
The buy orders, highest price first.
depthnumber
How many prices came back on each side.
levelnumber
The price the orders are grouped by, or 0 when they are not grouped.
markettext
Upbit's code for the market, quote currency first: KRW-BTC.
mid_pricenumber
Halfway between the best bid and the best ask.
pairtext
The market as people write it, coin first: BTC/KRW.
quote_currencytext
The currency it is priced in: KRW, BTC or USDT.
spreadnumber
The best ask minus the best bid.
spread_percentnumber
The spread as a percentage of the mid price.
summarytext
One line with the best bid and ask.
timetext
When Upbit read the order book, in ISO 8601 (UTC).
time_ksttext
The same time in Korea time (UTC+9).
total_ask_sizenumber
How much of the coin the listed asks add up to.
total_bid_sizenumber
How much of the coin the listed bids add up to.
Example output
{
  "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

MarketmarkettextRequired
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 lengthintervaltext
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 candlescountnumber
How many candles, from 1 to 200.From 1 to 200. Default: 30.
Beforebeforedate and time
Only candles before this time. Leave blank for the latest.
Also in Korean wonconvert_to_krwtrue/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_currencytext
The coin traded, such as BTC.
candleslist
The candles, newest first. A period with no trades has no candle.
change_percentnumber
The change from the oldest candle's open to the newest one's close, as a percentage.
countnumber
How many candles came back.
intervaltext
The candle length's key, such as day or 5_minutes.
interval_labeltext
The candle length in words, such as 1 day.
latest_closenumber
The newest candle's close.
markettext
Upbit's code for the market, quote currency first: KRW-BTC.
pairtext
The market as people write it, coin first: BTC/KRW.
quote_currencytext
The currency it is priced in: KRW, BTC or USDT.
summarytext
One line with the period covered and the latest close.
Example output
{
  "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

MarketsmarketslistRequired
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

countnumber
How many markets came back.
marketslist
Each market's price steps, in the order asked.
summarytext
One line with each market's tick size.
Example output
{
  "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

MarketsmarketslistRequired
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

countnumber
How many markets' prices came back.
summarytext
Each market's price and change, on one line.
tickerslist
Each market's price, in the order asked.
Example output
{
  "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 currenciesquote_currencieslistRequired
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 bysort_bytext
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 currencylimitnumber
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

countnumber
How many markets are listed.
quote_currencieslist
The quote currencies listed: KRW, BTC, USDT.
sort_bytext
How the list is sorted: value_24h, rise, fall or name.
summarytext
One line saying what is listed and how it is sorted.
tickerslist
Each market's price, grouped by quote currency in the order chosen, sorted within each.
totalnumber
How many markets those quote currencies have.
Example output
{
  "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 currencyquote_currencytext
Only markets priced in this currency. Leave blank for all three.One of: KRW (KRW (Korean won)), BTC (BTC (bitcoin)), USDT (USDT (tether)).
Name containssearchtext
Only markets whose code or coin name (English or Korean) contains this text, such as bitcoin or 비트코인.
Only flagged marketsflagged_onlytrue/false
Only markets under an investment warning or a caution.Default: false.

Outputs

caution_countnumber
How many listed markets are under a caution.
countnumber
How many markets matched and are listed.
marketslist
The matching markets: won markets first, then bitcoin, then tether, each by coin.
summarytext
One line saying how many markets matched.
totalnumber
How many markets Upbit lists in all.
warning_countnumber
How many listed markets are under a warning.
Example output
{
  "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

MarketmarkettextRequired
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 tradescountnumber
How many trades, from 1 to 500.From 1 to 500. Default: 50.
Daydays_agotext
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_timetime
Only trades made before this time of day, in UTC. Leave blank for the latest of the day.
Continue fromcursortext
To list earlier trades, the Next page value of an earlier List recent trades on the same market and day.

Outputs

average_pricenumber
The average price, weighted by volume.
base_currencytext
The coin traded, such as BTC.
buy_volumenumber
How much of it was bought.
countnumber
How many trades came back.
has_moretrue/false
True when there may be earlier trades that day.
markettext
Upbit's code for the market, quote currency first: KRW-BTC.
next_cursortext
Put this in Continue from to list the trades before these. Empty when there are no more.
pairtext
The market as people write it, coin first: BTC/KRW.
quote_currencytext
The currency it is priced in: KRW, BTC or USDT.
sell_volumenumber
How much of it was sold.
summarytext
One line with the period covered and its volume.
total_valuenumber
What they were worth in the quote currency.
total_volumenumber
How much of the coin those trades moved.
tradeslist
The trades, newest first.
Example output
{
  "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
    }
  ]
}

On this page