FOR AGENTS, CRYPTO RESEARCHERS & DEVELOPERS

Is Korea's crypto premium unusual today?

Compare Upbit's KRW prices with global prices on both official FX and KRW/USDT bases. Add historical percentiles and time series to your monitoring or research workflow.

See a free live BTC sampleConnect a workflow →

No wallet needed for previews. Check actual dates and archive depth before paying.

Choose the result your workflow needs

Compare multiple coins

$0.03 / call

Both premium bases for up to 10 coins in one response. Use it in an hourly market monitor.

Use the comparison API →

Put today's reading in context

$0.12 / call

Percentile, mean, deviation and z-score for one symbol over 1 hour to 90 days of observed archive data.

Use the statistics API →

Build a historical dataset

$0.08 / page

Timestamped prices and both premium bases. Follow the cursor to download longer windows.

Check archive coverage free →

Inspect the live sample

One BTC observation, fetched when you click. Multi-coin comparisons and historical statistics use the paid routes.

No request made yet.

Before integrating

Archive depth & freshness · OpenAPI · Agent instructions

The data uses last-traded prices, so timestamps, bid/ask spreads, liquidity, fees and transfer constraints matter. Readings describe market context; they are not net arbitrage returns.

All endpoints and prices, including quotes, FX, news and research
EndpointPriceResult
/api/kimchi-premium$0.03Kimchi premium on two bases: premium_official_pct (official USD/KRW rate — the quoted figure) and premium_usdt_pct (Upbit KRW/USDT rate — a gross spot-price comparison using KRW/USDT conversion, before spreads, fees, liquidity and transfer constraints). The two frequently disagree in sign. Optional ?symbols=BTC,ETH (max 10).
/api/kimchi-premium/stats$0.12Where the current kimchi premium sits inside its own recent distribution: percentile, mean, stdev, z-score, min/max/median, and a plain-language read. Answers 'is this premium unusual right now?' in one call. Built from the recorded archive; inspect actual dates and freshness with the free coverage endpoint. Params: ?symbol=BTC &window=1h|6h|24h|7d|30d|90d &basis=usdt|official.
/api/kimchi-premium/history$0.08Time series of the kimchi premium from the recorded archive, both bases, newest-last. Params: ?symbol=BTC &window=1h|6h|24h|7d|30d|90d &points=500 (max 2000) &before=<next_before>. Each page is a separate paid request. Continue while has_more is true using next_before. Inspect actual archive depth and freshness through /api/preview/premium-coverage before buying.
/api/research/consensus/:ticker$0.12Analyst consensus for one KRX ticker, built from the archived research history: mean/median/min/max target price across brokerages, the spread between them, the rating distribution, and a revision log of every target-price and rating change each house has made. Consensus uses each house's latest view, so a weekly publisher does not outvote a quarterly one. Params: ?window=30d|90d|180d|365d (default 90d).
/api/research/company/:ticker$0.05Every archived Korean brokerage report for one KRX ticker, newest first: target price, rating, brokerage, analyst, the Korean title with its English translation, and a one-line English summary. Params: ?limit=20 (max 50).
/api/research/latest$0.02Latest Korean brokerage equity research across all covered companies, newest first — company and KRX ticker, target price, rating, brokerage, analyst, and a one-line English summary of each report. Facts and summaries only; the report PDF stays with its publisher and source_url links back to it. Optional ?limit=20 (max 50).
/api/news/headlines/en$0.05Latest Korean headlines with English translations attached (title_en), from Yonhap, Maeil Business and Hankyung — deduplicated, newest first. Use this instead of the Korean-only route when the consuming agent does not read Korean. Optional ?category=top|economy|tech|politics and ?limit=20 (max 50).
/api/korea/market-snapshot$0.08One-call Korea briefing: dual-basis kimchi premium + top Upbit KRW markets + USD/KRW + latest economy headlines translated to English. Everything needed for a Korea market read in a single paid request.
/api/crypto/krw/markets$0.01Snapshot of all Upbit KRW crypto markets: top by 24h traded value, top gainers, top losers. Optional ?limit=30 (max 100) for the volume ranking.
/api/news/headlines$0.01Latest Korean headlines from Yonhap, Maeil Business and Hankyung, deduplicated and newest-first. Titles stay in Korean — use /api/news/headlines/en for English. Optional ?category=top|economy|tech|politics and ?limit=30 (max 100).
/api/crypto/krw/:ticker$0.005Live quote for one Upbit KRW market by ticker symbol (e.g. BTC, ETH, XRP): price, 24h change, 24h high/low, 24h traded value in KRW.
/api/fx/usdkrw$0.005Current USD/KRW exchange rate (ECB reference via Frankfurter, fallback open.er-api.com).