{"service":"K-Data x402","tagline":"Korean market data for AI agents — kimchi premium on a tradeable USDT basis, premium history and percentiles, Korean news translated to English, Upbit KRW quotes. Pay per request with USDC via x402. No account, no API key.","why_this_service":["Dual-basis kimchi premium: the official USD/KRW figure everyone quotes, plus the Upbit KRW/USDT basis that an arbitrageur can actually realize. The two often disagree in sign — official can read negative while the tradeable basis is positive.","Premium history and percentile context, continuously archived. No free source and no competing x402 seller offers this; it cannot be reconstructed after the fact.","Korean headlines translated to English, so a non-Korean agent can actually use them."],"payment":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:8453","currency":"USDC","how":"Request any paid endpoint without payment to receive HTTP 402 with payment requirements, pay with any x402 client (e.g. @x402/fetch), then retry with the payment header."},"base_url":"https://k-data-x402-production.theblack1022.workers.dev","free_endpoints":["/","/api/catalog","/openapi.json","/llms.txt"],"paid_endpoints":[{"method":"GET","path":"/api/kimchi-premium","price_usd":"$0.03","description":"Kimchi premium on two bases: premium_official_pct (official USD/KRW rate — the quoted figure) and premium_usdt_pct (Upbit KRW/USDT rate — the margin actually realizable, since the KRW exit leg goes through USDT rather than banks). The two frequently disagree in sign. Optional ?symbols=BTC,ETH (max 10).","query_params":{"properties":{"symbols":{"type":"string","description":"Comma-separated coin tickers, e.g. BTC,ETH,XRP. Default: BTC,ETH,XRP,SOL,DOGE"}}},"path_params":null,"output_example":{"usdkrw_official":1443.61,"usdkrw_usdt":1437,"usdt_premium_pct":-0.458,"entries":[{"ticker":"BTC","upbit_krw":90731000,"global_usd":63017.37,"premium_official_pct":-0.265,"premium_usdt_pct":0.193}],"as_of":"2026-08-01T00:00:00.000Z"}},{"method":"GET","path":"/api/kimchi-premium/stats","price_usd":"$0.12","description":"Where 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 a continuous archive that cannot be reconstructed from any free source. Params: ?symbol=BTC &window=1h|6h|24h|7d|30d|90d &basis=usdt|official.","query_params":{"properties":{"symbol":{"type":"string","description":"Archived tickers: BTC, ETH, XRP, SOL, DOGE, USDT"},"window":{"type":"string","enum":["1h","6h","24h","7d","30d","90d"],"description":"Lookback window (default 24h)"},"basis":{"type":"string","enum":["usdt","official"],"description":"Which premium basis to analyse (default usdt)"}}},"path_params":null,"output_example":{"symbol":"BTC","window":"7d","basis":"usdt","samples":2016,"current_pct":0.193,"percentile":92.4,"mean_pct":0.041,"stdev_pct":0.118,"zscore":1.288,"interpretation":"unusually high versus this window"}},{"method":"GET","path":"/api/kimchi-premium/history","price_usd":"$0.08","description":"Time series of the kimchi premium from the continuous archive, both bases, newest-last. Params: ?symbol=BTC &window=1h|6h|24h|7d|30d|90d &points=500 (max 2000). Archive depth is reported as first_recorded.","query_params":{"properties":{"symbol":{"type":"string","description":"Archived tickers: BTC, ETH, XRP, SOL, DOGE, USDT"},"window":{"type":"string","enum":["1h","6h","24h","7d","30d","90d"],"description":"Lookback window (default 24h)"},"points":{"type":"integer","description":"Max points returned (default 500, max 2000)"}}},"path_params":null,"output_example":{"symbol":"BTC","window":"24h","points":288,"first_recorded":"2026-08-01T14:20:00.000Z","series":[{"ts":"2026-08-01T14:25:00.000Z","upbit_krw":90731000,"global_usd":63017.37,"premium_official_pct":-0.265,"premium_usdt_pct":0.193}]}},{"method":"GET","path":"/api/news/headlines/en","price_usd":"$0.05","description":"Latest 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).","query_params":{"properties":{"category":{"type":"string","enum":["top","economy","tech","politics"],"description":"Filter by category"},"limit":{"type":"integer","description":"Max items (default 20, max 50)"}}},"path_params":null,"output_example":{"category":"economy","translated":true,"items":[{"title":"7월 수출 989억달러 역대 2위…반도체 두달째 400억달러대","title_en":"July exports at $98.9bn, second highest ever; chips above $40bn for a second month","link":"https://www.yna.co.kr/view/...","published_at":"2026-08-01T01:35:11.000Z","source":"연합뉴스 (Yonhap)"}]}},{"method":"GET","path":"/api/korea/market-snapshot","price_usd":"$0.08","description":"One-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.","query_params":null,"path_params":null,"output_example":{"kimchi_premium":{"usdkrw_official":1443.61,"usdkrw_usdt":1437,"entries":[]},"krw_markets":{"markets_total":277,"top_by_volume":[]},"fx":{"pair":"USD/KRW","rate":1443.61},"news_economy":{"translated":true,"items":[]},"as_of":"2026-08-01T00:00:00.000Z"}},{"method":"GET","path":"/api/crypto/krw/markets","price_usd":"$0.01","description":"Snapshot of all Upbit KRW crypto markets: top by 24h traded value, top gainers, top losers. Optional ?limit=30 (max 100) for the volume ranking.","query_params":{"properties":{"limit":{"type":"integer","description":"How many top-volume markets to return (default 30, max 100)"}}},"path_params":null,"output_example":{"markets_total":277,"top_by_volume":[{"market":"KRW-BTC","ticker":"BTC","price_krw":90731000,"change_24h_pct":1.2}],"top_gainers":[],"top_losers":[]}},{"method":"GET","path":"/api/news/headlines","price_usd":"$0.01","description":"Latest 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).","query_params":{"properties":{"category":{"type":"string","enum":["top","economy","tech","politics"],"description":"Filter by category"},"limit":{"type":"integer","description":"Max items (default 30, max 100)"}}},"path_params":null,"output_example":{"category":"economy","items":[{"title":"코스피, 외국인 매수세에 상승 마감","link":"https://www.yna.co.kr/view/...","published_at":"2026-08-01T00:00:00.000Z","source":"연합뉴스 (Yonhap)"}]}},{"method":"GET","path":"/api/crypto/krw/:ticker","price_usd":"$0.005","description":"Live 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.","query_params":null,"path_params":{"properties":{"ticker":{"type":"string","description":"Coin ticker symbol, e.g. BTC"}},"required":["ticker"]},"output_example":{"market":"KRW-BTC","ticker":"BTC","name_en":"Bitcoin","price_krw":90731000,"change_24h_pct":1.204,"volume_24h_krw":250000000000,"as_of":"2026-08-01T00:00:00.000Z"}},{"method":"GET","path":"/api/fx/usdkrw","price_usd":"$0.005","description":"Current USD/KRW exchange rate (ECB reference via Frankfurter, fallback open.er-api.com).","query_params":null,"path_params":null,"output_example":{"pair":"USD/KRW","rate":1443.61,"as_of":"2026-08-01","source":"frankfurter.dev (ECB)"}}]}