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
| Action | What it does |
|---|---|
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
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
markettextRequired - 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
depthnumber - How many prices to list on each side, from 1 to 30.From 1 to 30. Default:
15. - Group prices by
leveltext - 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
- Market
markettextRequired - 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
intervaltext - 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
countnumber - How many candles, from 1 to 200.From 1 to 200. Default:
30. - Before
beforedate and time - Only candles before this time. Leave blank for the latest.
- Also in Korean won
convert_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
- Markets
marketslistRequired - 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
- Markets
marketslistRequired - 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 currencies
quote_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 by
sort_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 currency
limitnumber - 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 currency
quote_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 contains
searchtext - Only markets whose code or coin name (English or Korean) contains this text, such as bitcoin or 비트코인.
- Only flagged markets
flagged_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
- Market
markettextRequired - 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
countnumber - How many trades, from 1 to 500.From 1 to 500. Default:
50. - Day
days_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 from
cursortext - 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
}
]
}