| name | upbit-cli |
| description | Upbit exchange CLI — market data, trading, deposits/withdrawals, real-time streams. Trigger: crypto price, trading, Upbit, buy/sell, candle, orderbook. |
Upbit CLI
AI-native CLI for Upbit cryptocurrency exchange. All commands output JSON in non-TTY mode.
Authentication
export UPBIT_ACCESS_KEY=your_key
export UPBIT_SECRET_KEY=your_secret
Market data commands work without authentication.
Commands
Market Data (no auth)
upbit ticker
View current price
| Param | Type | Description |
|---|
market | array | Market code (e.g. KRW-BTC, KRW-ETH) |
quote | string | View all prices by quote currency (e.g. KRW, BTC, USDT) |
Response: acc_trade_price_24h, acc_trade_volume_24h, change, change_price, change_rate, high_price...
upbit candle
View candles
| Param | Type | Description |
|---|
asc | boolean | Sort oldest first (default) |
count | integer | Number of results |
desc | boolean | Sort newest first |
force | boolean | Skip confirmation prompt |
from | string | Start time (e.g. 2025-01-01, 2025-01-01T09:00:00+09:00) |
interval | string | Candle interval (1s, 1m, 3m, 5m, 10m, 15m, 30m, 60m, 240m, 1d, 1w, 1M, 1y) |
market | string | Market code (e.g. KRW-BTC) |
no-cache | boolean | Skip cache |
Response: candle_acc_trade_price, candle_acc_trade_volume, candle_date_time_kst, candle_date_time_utc, high_price, low_price...
upbit market
List markets
| Param | Type | Description |
|---|
quote | string | Quote currency filter (KRW, BTC, USDT) |
Response: english_name, korean_name, market
upbit orderbook
View orderbook
| Param | Type | Description |
|---|
market | array | Market code (e.g. KRW-BTC) |
Response: market, orderbook_units, total_ask_size, total_bid_size
upbit trades
View recent trades
| Param | Type | Description |
|---|
count | integer | Number of results |
market | string | Market code (e.g. KRW-BTC) |
Response: ask_bid, market, trade_price, trade_timestamp, trade_volume
upbit tick-size
View tick size
| Param | Type | Description |
|---|
market | array | (req) |
Response: market, quote_currency, tick_size
upbit orderbook-levels
View orderbook level units
| Param | Type | Description |
|---|
market | array | (req) |
Trading (auth required)
upbit buy
Place buy order
| Param | Type | Description |
|---|
force | boolean | Skip confirmation prompt |
id | string | Client-specified order identifier |
market | string | Market code to buy (e.g. KRW-BTC) (req) |
price | string | Order price |
smp | string | Self-trade prevention (cancel_maker, cancel_taker, reduce) |
test | boolean | Test order (no actual execution) |
tif | string | Time in Force (ioc, fok, post_only) |
total | string | Order total (market buy) |
volume | string | Order volume |
Response: created_at, executed_volume, market, ord_type, price, remaining_volume...
upbit sell
Place sell order
| Param | Type | Description |
|---|
force | boolean | Skip confirmation prompt |
id | string | Client-specified order identifier |
market | string | Market code to sell (e.g. KRW-BTC) (req) |
price | string | Order price |
smp | string | Self-trade prevention (cancel_maker, cancel_taker, reduce) |
test | boolean | Test order (no actual execution) |
tif | string | Time in Force (ioc, fok, post_only) |
volume | string | Order volume |
Response: created_at, executed_volume, market, ord_type, price, remaining_volume...
upbit balance
View account balance
| Param | Type | Description |
|---|
currency | string | Currency code to query (e.g. KRW, BTC) |
Response: avg_buy_price, balance, currency, eval_krw, locked
upbit order list
List orders
| Param | Type | Description |
|---|
closed | boolean | Show closed orders |
count | integer | Number of results |
market | string | Market filter (e.g. KRW-BTC) |
page | integer | Page number |
Response: created_at, executed_volume, market, ord_type, price, remaining_volume...
upbit order show
View order details
| Param | Type | Description |
|---|
id | boolean | Query by identifier (instead of UUID) |
uuid | array | Order/deposit/withdrawal UUID (req) |
Response: created_at, executed_volume, market, ord_type, price, remaining_volume...
upbit order cancel
Cancel order
| Param | Type | Description |
|---|
all | boolean | Cancel all pending orders |
force | boolean | Skip confirmation prompt |
market | string | Market filter (use with --all) |
uuid | string | UUID to cancel |
upbit order replace
Replace order (cancel and re-order)
| Param | Type | Description |
|---|
force | boolean | Skip confirmation prompt |
ord-type | string | Order type (limit, best) |
price | string | New order price |
uuid | string | Order UUID to replace (req) |
volume | string | New order volume |
upbit order chance
View order chance by market
| Param | Type | Description |
|---|
market | string | Market code for order chance (e.g. KRW-BTC) (req) |
Deposits & Withdrawals (auth required)
upbit wallet
View wallet service status
upbit deposit list
List deposits
| Param | Type | Description |
|---|
count | integer | Number of results |
currency | string | Currency code filter (e.g. BTC, KRW) |
page | integer | Page number |
state | string | Deposit state filter (PROCESSING, ACCEPTED, CANCELLED, REJECTED) |
upbit deposit show
View deposit details
| Param | Type | Description |
|---|
uuid | string | Order/deposit/withdrawal UUID (req) |
upbit deposit address create
Request deposit address creation
| Param | Type | Description |
|---|
currency | string | (req) |
net-type | string | Network type (default: same as currency) |
upbit withdraw list
List withdrawals
| Param | Type | Description |
|---|
count | integer | Number of results |
currency | string | Currency code filter (e.g. BTC, KRW) |
page | integer | Page number |
state | string | Withdrawal state filter (WAITING, PROCESSING, DONE, FAILED, CANCELLED, REJECTED) |
upbit withdraw show
View withdrawal details
| Param | Type | Description |
|---|
uuid | string | Order/deposit/withdrawal UUID (req) |
upbit withdraw request
Request withdrawal
| Param | Type | Description |
|---|
amount | string | Withdrawal amount (required) |
currency | string | Currency code to withdraw (e.g. BTC, KRW) (req) |
force | boolean | Skip confirmation prompt |
net-type | string | Network type (default: same as currency) |
secondary-address | string | Secondary address (tag/memo) |
to | string | Recipient address (required for digital assets) |
two-factor | string | 2FA method (kakao, naver, hana) — KRW only |
tx-type | string | Transaction type (default, internal) |
upbit withdraw cancel
Cancel withdrawal
| Param | Type | Description |
|---|
force | boolean | Skip confirmation prompt |
uuid | string | UUID to cancel (req) |
Real-time WebSocket
upbit watch ticker
Real-time ticker stream
| Param | Type | Description |
|---|
market | array | Market code (e.g. KRW-BTC, KRW-ETH) (req) |
upbit watch orderbook
Real-time orderbook stream
| Param | Type | Description |
|---|
market | array | Market code (e.g. KRW-BTC) (req) |
upbit watch trade
Real-time trade stream
| Param | Type | Description |
|---|
market | array | (req) |
upbit watch candle
Real-time candle stream
| Param | Type | Description |
|---|
interval | string | Candle unit (1s, 1m, 3m, 5m, 10m, 15m, 30m, 60m, 240m) |
market | array | Market code (e.g. KRW-BTC) (req) |
upbit watch my-order
Real-time my orders stream (auth required)
| Param | Type | Description |
|---|
market | array | |
upbit watch my-asset
Real-time my assets stream (auth required)
Utilities
upbit api-keys
List API keys
| Param | Type | Description |
|---|
all | boolean | Show all including expired |
upbit cache
Cache management
| Param | Type | Description |
|---|
clear | boolean | Clear cache |
force | boolean | Skip confirmation prompt |
upbit update
Check and install latest version
| Param | Type | Description |
|---|
check | boolean | Check only, don't download |
Output
- Non-TTY: JSON (automatic)
-o json/csv/jsonl/table--json field1,field2 for field selection
Examples
upbit ticker KRW-BTC -o json
upbit candle KRW-BTC -i 1d --from 2025-01-01 -o csv
upbit buy KRW-BTC -p 100000000 -V 0.001 --force
upbit balance -o json
upbit order list -o json
