Korea Upbit & Bithumb Crypto

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.

📊 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.

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