{"service":"K-Data x402","tagline":"Korean market context for AI agents: dual-basis crypto premiums, archived history and percentiles, KRW quotes, FX, English headlines and equity research. Inspect live BTC data and archive coverage free, then pay per request with USDC via x402.","why_this_service":["Compare Korean crypto prices on both official USD/KRW and Upbit KRW/USDT conversion bases. These are gross spot-price comparisons, excluding spreads, fees, liquidity and transfer constraints.","Continuously recorded premium history and percentile context. Check real sample counts, dates and freshness through the free archive-coverage endpoint before buying.","Korean headlines translated to English, so a non-Korean agent can actually use them.","Structured Korean equity research metadata and archived brokerage revisions remain available through the existing research routes."],"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","/integrate","/premium-workflow.mjs","/api/preview/premium-coverage","/api/preview/kimchi-premium","/api/preview/research/coverage","/api/preview/research/:ticker"],"workflows":[{"job":"Multi-coin premium monitoring","endpoint":"/api/kimchi-premium","preview":"/api/preview/kimchi-premium","guide":"/integrate#compare"},{"job":"Historical percentile context","endpoint":"/api/kimchi-premium/stats","preview":"/api/preview/premium-coverage","guide":"/integrate#stats"},{"job":"Historical dataset","endpoint":"/api/kimchi-premium/history","preview":"/api/preview/premium-coverage","note":"Each page is paid; follow next_before within your budget."}],"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 — 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).","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 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.","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","percentile_method":"midrank: ties contribute half their count","latest_recorded":"2026-08-01T14:25:00.000Z","age_seconds":60,"stale":false}},{"method":"GET","path":"/api/kimchi-premium/history","price_usd":"$0.08","description":"Time 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.","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)"},"before":{"type":"integer","description":"Unix-second cursor from next_before; returns older rows strictly before it"}}},"path_params":null,"output_example":{"symbol":"BTC","window":"24h","points":288,"first_recorded":"2026-08-01T14:20:00.000Z","has_more":true,"next_before":"1785594000","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/research/consensus/:ticker","price_usd":"$0.12","description":"Analyst 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).","query_params":{"properties":{"window":{"type":"string","enum":["30d","90d","180d","365d"],"description":"Lookback window (default 90d)"}}},"path_params":{"properties":{"ticker":{"type":"string","description":"6-digit KRX code, e.g. 005930"}},"required":["ticker"]},"output_example":{"ticker":"011200","company":"HMM","window":"90d","reports_total":34,"brokers":12,"consensus":{"mean_target":30417,"median_target":30000,"min_target":26000,"max_target":35000,"spread_pct":29.59,"ratings":{"Buy":10,"Hold":2}},"changes":[{"published_date":"2026-07-31","broker":"LS증권","analyst":"이재혁","target_price":30000,"prev_target_price":27000,"target_change_pct":11.11,"target_direction":"raised","rating":"Buy","prev_rating":null,"rating_direction":null}],"series":[{"report_idx":651350,"published_date":"2026-07-31","broker":"LS증권","analyst":"이재혁","target_price":30000,"rating":"Buy"}],"first_recorded":"2026-08-02","as_of":"2026-08-02T00:00:00.000Z"}},{"method":"GET","path":"/api/research/company/:ticker","price_usd":"$0.05","description":"Every 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).","query_params":{"properties":{"limit":{"type":"integer","description":"Max reports (default 20, max 50)"}}},"path_params":{"properties":{"ticker":{"type":"string","description":"6-digit KRX code, e.g. 005930"}},"required":["ticker"]},"output_example":{"ticker":"011200","company":"HMM","count":3,"first_recorded":"2026-08-02","items":[{"report_idx":651350,"published_date":"2026-07-31","ticker":"011200","company":"HMM","title":"2Q26 Preview: 건물 사이에 피어난 장미","title_en":"2Q26 Preview: a rose blooming between the buildings","summary_en":"LS Securities rates HMM (011200) Buy with a KRW 30,000 target in a 2Q26 preview by analyst Lee Jae-hyuk.","target_price":30000,"rating":"Buy","rating_raw":"Buy","analyst":"이재혁","broker":"LS증권","source_url":"https://consensus.hankyung.com/analysis/downpdf?report_idx=651350"}],"as_of":"2026-08-02T00:00:00.000Z"}},{"method":"GET","path":"/api/research/latest","price_usd":"$0.02","description":"Latest 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).","query_params":{"properties":{"limit":{"type":"integer","description":"Max reports (default 20, max 50)"}}},"path_params":null,"output_example":{"count":20,"items":[{"report_idx":651350,"published_date":"2026-07-31","ticker":"011200","company":"HMM","title":"2Q26 Preview: 건물 사이에 피어난 장미","title_en":"2Q26 Preview: a rose blooming between the buildings","summary_en":"LS Securities rates HMM (011200) Buy with a KRW 30,000 target in a 2Q26 preview by analyst Lee Jae-hyuk.","target_price":30000,"rating":"Buy","rating_raw":"Buy","analyst":"이재혁","broker":"LS증권","source_url":"https://consensus.hankyung.com/analysis/downpdf?report_idx=651350"}],"as_of":"2026-08-02T00:00:00.000Z"}},{"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)","related_resources":{"integration_guide":"/integrate","free_market_preview":"/api/preview/kimchi-premium","free_archive_coverage":"/api/preview/premium-coverage","catalog":"/api/catalog"}}}]}