Korea Upbit & Bithumb Crypto — 김치프리미엄 API

Korea Upbit & Bithumb Crypto

Korea Upbit & Bithumb Crypto is a NexGenData tool on Apify that returns KRW crypto tickers and the kimchi premium from the Upbit and Bithumb exchanges.

Track Korea Upbit and Bithumb crypto tickers and the kimchi premium. Built for analysts, quants, fintech builders and AI agents.

Factual public data — not financial or investment advice.

📊 Sample Output

exchange	bid	ask	mid	last	volume_24h_KRW
upbit	115129000	115172000	115150500	115172000	103913852079.82993
upbit	3666000	3668000	3667000	3668000	73621967830.27863
bithumb	115153000	115158000	115155500	115151000	34618581000.77279
bithumb	3667000	3668000	3667500	3668000	28434703746.92574

Real rows from run pa5qr8pNH0E8cmuxq on build 0.0.7 (2026-09-25), unedited apart from masked emails/phones and shortened long text; fields the source does not publish are empty.

🔧 Input reference

Field	Type	Default	What it does
exchanges	array	["upbit", "bithumb"]	Which Korean exchanges to query. Choose any combination of Upbit and Bithumb. Leave unset to query both.
symbols	string	"BTC,ETH"	Comma-separated base symbols to pull (uppercase, KRW quote assumed). Example: BTC,ETH,XRP,SOL. Required: with no symbols the run returns 0 rows and charges nothing.
include_kimchi_premium	boolean	true	If true, fetch a USD reference spot price for each symbol and compute the kimchi-premium percentage versus the KRW exchange price. The reference source is set by usd_reference.
usd_reference	string (coingecko, binance, none)	"coingecko"	Where to fetch the USD reference price for the kimchi-premium calc. coingecko = CoinGecko public API. binance = Binance public spot API (USDT pair). none = skip USD reference (kim…
max_records	integer	30	Upper bound on total ticker records emitted (across all exchanges x symbols).

🧾 JSON sample record

One real record from run pa5qr8pNH0E8cmuxq (emails/phones masked, long text shortened):

{
  "exchange": "upbit",
  "symbol": "BTC",
  "base": "BTC",
  "quote": "KRW",
  "bid": 115129000,
  "ask": 115172000,
  "mid": 115150500,
  "last": 115172000,
  "volume_24h_KRW": 103913852079.82993,
  "timestamp": "2026-09-25T00:03:24.531000+00:00",
  "source_url": "https://api.upbit.com/v1/ticker?markets=KRW-BTC,KRW-ETH",
  "fetched_at": "2026-09-25T00:03:24.791161+00:00",
  "usd_reference_price": 84388,
  "kimchi_premium_pct": -0.017,
  "usdkrw_rate": 1364.768247,
  "usdkrw_source": "open.er-api.com",
  "kimchi_premium_status": "ok"
}

💰 Pricing

Event	Price (USD)	When it is charged
Actor Start (apify-actor-start)	$0.005	Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event).
Ticker record (ticker-record)	$0.05	Per Korean crypto ticker quote with kimchi premium calculation

Pay-per-event: you pay only for what the run delivers. A run that delivers nothing bills no result events (only the actor-start event, when the actor defines one). Example: a run that delivers 100 results costs 100 × $0.05 = $5.00 plus the start fee.

🔗 Related Actors

More from the NexGenData Korea & Japan family:

• Korea KIPO Patents & Trademarks — 특허 검색 API
• Korea KRX Market Statistics — 한국 주식 API
• Korea KRX Short Selling — 공매도 API
• KOSPI Korea Stock Screener — 한국 주식 Data API
• Naver Trends News — Korea News Monitoring API
• Niconico Video Search — ニコニコ動画 API

17 more in this family on the NexGenData Store page.

📊 What you get

Clean JSON, one record per exchange × symbol:

• exchange — upbit or bithumb
• symbol / base / quote — e.g. BTC / BTC / KRW
• bid · ask · mid · last — live KRW top-of-book and last trade
• volume_24h_KRW — 24h traded value in KRW
• timestamp · fetched_at — exchange trade time and fetch time (UTC)
• usd_reference_price — USD spot from the chosen reference source (CoinGecko or Binance)
• usdkrw_rate · usdkrw_source — the real USD/KRW rate used, and where it came from
• kimchi_premium_pct — KRW price vs the USD reference converted at that rate
• kimchi_premium_status — ok, not_requested, usdkrw_fx_unavailable, or usd_reference_unavailable
• source_url — the exact exchange endpoint the row came from

The kimchi premium is only reported when a live USD/KRW rate and a live USD reference price were both fetched. If either is unavailable the premium is null with a reason — no estimated or assumed FX rate is ever used.

Pricing (Pay-Per-Event): $0.05 per ticker record (ticker-record) — about 20 records per $1 — plus $0.005 per Actor start event.

If the exchanges answer and none of your symbols is listed on a KRW market, the run finishes with 0 rows and an explanatory status message, and nothing is charged. If an exchange API is unreachable, the run fails loudly rather than returning an empty success.

🤖 Use with AI agents

Structured JSON built for LLM and agent pipelines — point Claude, the OpenAI Agents SDK, an n8n flow or any MCP-aware client at it and pull Korea Upbit and Bithumb crypto tickers with kimchi premium on demand.

Sample agent prompt:

Show BTC on Upbit vs global price and the current kimchi premium.

Agentic payments (x402): Supports agentic payment via x402 — agents can call this actor with USDC, no API key required.

⏰ Run on a schedule

This is a monitoring play — schedule a recurring pull:

{
  "symbols": "BTC,ETH,XRP",
  "exchanges": ["upbit", "bithumb"],
  "max_records": 30
}

한국어 안내

이 Actor는 한국 업비트·빗썸 암호화폐 시세와 김치프리미엄(매수/매도 호가, 최종가)을(를) 깔끔한 JSON으로 제공합니다. 분석가, 퀀트 리서처, 핀테크 개발자, AI 에이전트를 위해 설계되었습니다. 「시세 기록」 1건당 $0.05로 과금되며(달러당 약 20건), 정기 실행을 지원해 매일·매주 자동으로 한국 거래소 시세와 김치프리미엄을(를) 수집할 수 있습니다. 공개 데이터이며 투자 자문이 아닙니다.

🔗 Related Korea actors

China data suite: DART Filings, KIND Disclosures, KRX Market Stats, IPO Pipeline

Cross-market hubs: APAC Disclosure Monitor, APAC IPO Calendar Sweep

---

*Data from public Korean market and government sources. Factual public data — not financial or investment advice.

공개 데이터이며 투자 자문이 아닙니다.*