{"openapi":"3.1.0","info":{"title":"POKT Agent — Korea data and checks for AI agents (x402)","version":"1.0.0","description":"Pay-per-call Korean company due diligence, company ID crosswalk, sanctions screening with Korean name variants, Upbit/Bithumb risk events, HWP to Markdown, business status, business-day calendar, address normalisation, law, rates, filings and more. No account or API key: pay each call in USDC on Base via x402.","contact":{"url":"https://pokt-agent.com/","email":"seungyeop@pokt-agent.com","name":"POKT Agent"}},"servers":[{"url":"https://x402.pokt-agent.com"}],"paths":{"/kr-law/query":{"post":{"summary":"Korean law","description":"Korean law: ask about a Korean statute in Korean or English and get the matching law and article text from the National Law Information Center, with the official article number, effective date and source link.","operationId":"POST_kr_law_query","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"law":"자본시장과 금융투자업에 관한 법률","article":"제178조","text":"…","source":"law.go.kr"}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"question":{"type":"string"},"law":{"type":"string"},"no":{"type":"string"}},"required":["question"]},"example":{"question":"자본시장법 제178조 내용"}}}}}},"/kr-law/article":{"get":{"summary":"Korean law article lookup","description":"Korean law article lookup: the official text of one article of a Korean statute by law name (Korean, common abbreviation or English) and article number, from the National Law Information Center.","operationId":"GET_kr_law_article","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"law":"자본시장과 금융투자업에 관한 법률","article":"제178조","text":"…"}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"parameters":[{"name":"law","in":"query","required":true,"schema":{"type":"string"}},{"name":"no","in":"query","required":true,"schema":{"type":"string"}}]}},"/kr-rates/query":{"post":{"summary":"Korean rates and FX","description":"Korean rates and FX: Bank of Korea base rate, KOFR, CD, CP, KTB yields 1y-50y (ECOS) and won exchange rates (KEXIM, customs) for a date, from an English or Korean question. Official values with series id, date and source.","operationId":"POST_kr_rates_query","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"items":[{"series":"USDKRW","value":1380.5,"date":"2026-10-10","source":"KEXIM"}]}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"question":{"type":"string"},"date":{"type":"string"}},"required":["question"]},"example":{"question":"USD/KRW and 3y KTB yield today"}}}}}},"/kr-rates/fx":{"get":{"summary":"Won exchange rate for one currency on a date","description":"Won exchange rate for one currency on a date: KEXIM deal basis rate plus TTB and TTS, with the official date and source.","operationId":"GET_kr_rates_fx","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"ccy":"USD","deal_basis":1380.5,"ttb":1366.7,"tts":1394.3,"date":"2026-10-10","source":"KEXIM"}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"parameters":[{"name":"ccy","in":"query","required":true,"schema":{"type":"string"}},{"name":"date","in":"query","required":false,"schema":{"type":"string"}}]}},"/kr-figures/check":{"post":{"summary":"Fact-check numbers in Korean finance text","description":"Fact-check numbers in Korean finance text: every checkable number (rates, KTB yields, FX, listed-company revenue and profit, % vs %p, 조/억/만 units) marked MATCH or MISMATCH against the official value with date and source (ECOS, KEXIM, DART). Numbers with no source stay unverified.","operationId":"POST_kr_figures_check","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"checks":[{"claim":"기준금리 3.25%","verdict":"MISMATCH","official":2.5,"date":"2026-10-10","source":"ECOS"}]}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string"},"as_of":{"type":"string"},"corp":{"type":"string"},"year":{"type":"integer"}},"required":["text"]},"example":{"text":"기준금리는 3.25%이고 삼성전자 2025년 매출은 300조원이다."}}}}}},"/dart-impact/impact":{"post":{"summary":"Which parts of a report did a later DART correction change? Send a Korean listed","description":"Which parts of a report did a later DART correction change? Send a Korean listed company, the DART receipt numbers your report cites and/or the report text; get the corrections filed since, each changed term with before and after values, and which of your cited figures are affected.","operationId":"POST_dart_impact_impact","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"corrections":[{"rcept_no":"20260901000456","changed":[{"term":"매출액","before":"…","after":"…"}]}],"affected":[]}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"corp":{"type":"string"},"corp_code":{"type":"string"},"rcept_nos":{"type":"array","items":{"type":"string"}},"text":{"type":"string"},"since":{"type":"string"}},"required":[]},"example":{"corp":"삼성전자","rcept_nos":["20260814000123"]}}}}}},"/kr-apt/query":{"post":{"summary":"Korean apartment sale prices from the MOLIT real-transaction register","description":"Korean apartment sale prices from the MOLIT real-transaction register: trades, median price and price per m2 by district, month and complex, from a Korean or English question. Observed registered trades only.","operationId":"POST_kr_apt_query","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"region":"강남구","months":[{"month":"2026-09","count":312,"median_price_krw":2650000000}],"source":"MOLIT"}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"question":{"type":"string"},"region":{"type":"string"},"month":{"type":"string"},"apt":{"type":"string"},"months":{"type":"integer"}},"required":["question"]},"example":{"question":"Gangnam-gu apartment median price trend last 6 months"}}}}}},"/kr-apt/trend":{"get":{"summary":"Monthly apartment trade count, median price and median price per m2 for one Kore","description":"Monthly apartment trade count, median price and median price per m2 for one Korean district (or one complex) over recent months, from the MOLIT real-transaction register.","operationId":"GET_kr_apt_trend","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"region":"강남구","rows":[{"month":"2026-09","count":312,"median_price_krw":2650000000,"median_per_m2_krw":31000000}]}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"parameters":[{"name":"region","in":"query","required":true,"schema":{"type":"string"}},{"name":"months","in":"query","required":false,"schema":{"type":"string"}},{"name":"apt","in":"query","required":false,"schema":{"type":"string"}}]}},"/kr-export/query":{"post":{"summary":"South Korea's exports from Korea Customs Service statistics","description":"South Korea's exports from Korea Customs Service statistics: 10-day provisional totals, change vs prior month and year, major items, HS codes and countries, with revisions tracked. Korean or English question; observed values only.","operationId":"POST_kr_export_query","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"period":"2026-10-01..10","exports_usd":15200000000,"yoy_pct":6.1,"source":"KCS"}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"question":{"type":"string"},"hs":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"},"country":{"type":"string"},"months":{"type":"integer"}},"required":["question"]},"example":{"question":"Korea semiconductor exports to China this month vs last year"}}}}}},"/kr-export/pulse":{"get":{"summary":"Latest Korean export period vs the prior month and prior year at the same stage,","description":"Latest Korean export period vs the prior month and prior year at the same stage, with each major item's contribution, from Korea Customs Service statistics.","operationId":"GET_kr_export_pulse","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"latest":"2026-10-01..10","yoy_pct":6.1,"contributions":[{"item":"semiconductors","pp":4.2}]}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"parameters":[{"name":"months","in":"query","required":false,"schema":{"type":"string"}}]}},"/dart-events/query":{"post":{"summary":"Korean listed-company disclosures from OpenDART as change tracking","description":"Korean listed-company disclosures from OpenDART as change tracking: filings, corrections linked to their originals with before and after values, and a point-in-time view. Ask about a company in Korean or English.","operationId":"POST_dart_events_query","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"corp":"삼성전자","corrections":[{"rcept_no":"20260901000456","original":"20260814000123","changed_terms":2}]}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"question":{"type":"string"},"corp_code":{"type":"string"},"name":{"type":"string"},"stock_code":{"type":"string"},"since":{"type":"string"},"date":{"type":"string"}},"required":["question"]},"example":{"question":"Samsung Electronics corrections since September"}}}}}},"/dart-events/changes":{"get":{"summary":"Corrections and withdrawals filed on OpenDART by one Korean company since a date","description":"Corrections and withdrawals filed on OpenDART by one Korean company since a date, each linked to the original filing with the changed terms (before and after).","operationId":"GET_dart_events_changes","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"corp_code":"00126380","changes":[{"rcept_no":"20260901000456","original":"20260814000123","terms":[{"term":"매출액","before":"…","after":"…"}]}]}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"parameters":[{"name":"corp_code","in":"query","required":true,"schema":{"type":"string"}},{"name":"since","in":"query","required":false,"schema":{"type":"string"}}]}},"/backtest/reconcile":{"post":{"summary":"Check a trading backtest","description":"Check a trading backtest: recompute net profit, win rate, profit factor, max drawdown and trade count from the trade list (CSV or JSON) and compare them with the claimed numbers. Returns each metric as MATCH or MISMATCH with the recomputed value and finding codes.","operationId":"POST_backtest_reconcile","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"metrics":[{"name":"net_profit","claimed":10,"recomputed":10,"verdict":"MATCH"}],"findings":[]}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"trades_csv":{"type":"string"},"trades":{"type":"array"},"initial_capital":{"type":"number"},"commission":{"type":"number"},"claimed":{"type":"object"},"tolerance_pct":{"type":"number"},"single_position":{"type":"boolean"}},"required":[]},"example":{"trades":[{"n":1,"side":"long","entry_time":"2026-01-02 10:00","exit_time":"2026-01-03 10:00","entry_price":100,"exit_price":110,"qty":1}],"initial_capital":1000,"claimed":{"net_profit":10}}}}}}},"/kr-biz/status":{"get":{"summary":"Korean business registration number check (KYB)","description":"Korean business registration number check (KYB): is a Korean company active, suspended or closed, and its VAT taxpayer type, live from the National Tax Service. Malformed numbers are rejected by check digit without an upstream call. Results are not stored.","operationId":"GET_kr_biz_status","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"results":[{"b_no":"2208162517","checksum_ok":true,"status":"active","status_ko":"계속사업자","tax_type":"부가가치세 일반과세자"}]}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"parameters":[{"name":"b_no","in":"query","required":true,"schema":{"type":"string","description":"10-digit Korean business registration number"}}]},"post":{"summary":"Batch Korean business registration check","description":"Batch Korean business registration check: status (active, suspended, closed, not registered) and VAT type for up to 100 Korean business numbers in one call, live from the National Tax Service.","operationId":"POST_kr_biz_status","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"results":[{"b_no":"2208162517","status":"active"},{"b_no":"1234567890","status":"invalid_number"}]}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"b_no":{"type":"array","items":{"type":"string"},"maxItems":100}},"required":["b_no"]},"example":{"b_no":["220-81-62517","1234567890"]}}}}}},"/kr-calendar/add":{"get":{"summary":"Korean business days","description":"Korean business days: the date N business days after (or before) a date, skipping weekends and official Korean public holidays including substitute and temporary holidays (KASI list). Lists the holidays skipped.","operationId":"GET_kr_calendar_add","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"start":"2026-09-23","n":1,"result":"2026-09-28","holidays_skipped":["2026-09-24 추석","2026-09-25 추석","2026-09-26 추석"]}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"parameters":[{"name":"date","in":"query","required":true,"schema":{"type":"string","description":"YYYY-MM-DD"}},{"name":"n","in":"query","required":true,"schema":{"type":"string","description":"integer, negative for earlier"}}]}},"/kr-calendar/count":{"get":{"summary":"Count Korean business days between two dates (after from, up to and including to","description":"Count Korean business days between two dates (after from, up to and including to), excluding weekends and official Korean public holidays, with the holidays in range.","operationId":"GET_kr_calendar_count","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"from":"2026-09-30","to":"2026-10-31","business_days":20,"holidays_in_range":["2026-10-03 개천절","2026-10-05 대체공휴일(개천절)","2026-10-09 한글날"]}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"parameters":[{"name":"from","in":"query","required":true,"schema":{"type":"string"}},{"name":"to","in":"query","required":true,"schema":{"type":"string"}}]}},"/kr-calendar/day":{"get":{"summary":"Is a date a Korean business day? Weekday, weekend flag, and official Korean publ","description":"Is a date a Korean business day? Weekday, weekend flag, and official Korean public holiday names (including substitute and temporary holidays) from the KASI special-day list.","operationId":"GET_kr_calendar_day","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"date":"2026-10-05","weekday":"Mon","is_holiday":true,"holiday_names":["대체공휴일(개천절)"],"is_business_day":false}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"parameters":[{"name":"date","in":"query","required":true,"schema":{"type":"string"}}]}},"/kr-reader/read":{"post":{"summary":"Read a Korean web page as clean text","description":"Read a Korean web page as clean text: Naver Blog posts (inside the iframe), Naver News and Daum News articles, and generic pages, returned as title, author, published date, clean paragraphs, images and links. Deterministic extraction, no LLM. Naver Cafe is reported as unsupported.","operationId":"POST_kr_reader_read","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"site":"naver_news","status":"OK","title":"…","author":"연합뉴스","published":"2026-10-10T09:12:00+09:00","text":"…","chars":2389}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"max_chars":{"type":"integer"}},"required":["url"]},"example":{"url":"https://n.news.naver.com/article/001/0016369438"}}}}}},"/kr-address/search":{"get":{"summary":"Normalise a Korean address","description":"Normalise a Korean address: official road-name and lot-number forms, 5-digit postal code, English address, building name and codes, from the Ministry of the Interior road-name address API. Accepts partial Korean addresses (road plus number, or district plus building).","operationId":"GET_kr_address_search","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"total":1,"results":[{"road_address":"서울특별시 종로구 세종대로 209 (세종로)","postal_code":"03171","english":"209 Sejong-daero, Jongno-gu, Seoul"}]}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}}]}},"/kr-dd/report":{"post":{"summary":"Korea company due diligence report (KYB) in English","description":"Korea company due diligence report (KYB) in English: identity and IDs, live National Tax Service status, normalised address, 3 years of financials (revenue, operating profit, debt ratio), recent DART filings and corrections, auditor opinion, and risk flags, each with its official source and date. Facts only, not a rating.","operationId":"POST_kr_dd_report","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"company":{"name":"Kakao Corp.","stock_code":"035720","market":"KOSPI","nts_status":"active"},"sections":{"financials":{"years":[{"fiscal_year":2025,"revenue":8099147815086,"operating_profit":732036535379,"debt_ratio_pct":82.5}]},"audit":{"opinion_en":"unqualified"}},"flags":[{"code":"FREQUENT_CORRECTIONS","severity":"warn"}]}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"stock_code":{"type":"string"},"corp_code":{"type":"string"},"b_no":{"type":"string"},"lang":{"type":"string","enum":["en","ko"]}},"required":[]},"example":{"query":"Kakao"}}}}}},"/kr-dd/resolve":{"get":{"summary":"Find a listed Korean company by Korean or English name, or by stock code","description":"Find a listed Korean company by Korean or English name, or by stock code: DART corp_code, Korean and English names and stock code, with candidates when the name is ambiguous.","operationId":"GET_kr_dd_resolve","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"ambiguous":true,"candidates":[{"corp_code":"00126380","name_en":"SAMSUNG ELECTRONICS CO,.LTD","stock_code":"005930"}]}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}}]}},"/kr-crypto/events":{"get":{"summary":"Korean crypto exchange risk events from Upbit and Bithumb as structured English ","description":"Korean crypto exchange risk events from Upbit and Bithumb as structured English events: trading warning or caution designations and releases, delistings with effective time, deposit or withdrawal suspensions and resumptions per network, network upgrades and new listings. Filter by ticker, exchange, type and time.","operationId":"GET_kr_crypto_events","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"events":[{"exchange":"bithumb","type":"WARNING_SET","tickers":["XAI"],"announced_at":"2026-10-10T08:00:00Z","summary_en":"Bithumb designated XAI as a trading warning asset"}]}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"parameters":[{"name":"since","in":"query","required":false,"schema":{"type":"string"}},{"name":"exchange","in":"query","required":false,"schema":{"type":"string","enum":["upbit","bithumb"]}},{"name":"type","in":"query","required":false,"schema":{"type":"string"}},{"name":"ticker","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}}]}},"/kr-crypto/ticker":{"get":{"summary":"Current Korean exchange risk status for one coin on Upbit and Bithumb","description":"Current Korean exchange risk status for one coin on Upbit and Bithumb: warning and caution flags, pending delisting with its date, and suspended deposit or withdrawal networks. Check before trading or routing a transfer to a Korean exchange.","operationId":"GET_kr_crypto_ticker","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"symbol":"ICX","upbit":{"warning":false,"delisting":{"effective_at":"2026-10-19T06:00:00Z"}},"bithumb":{"warning":false}}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"}}]}},"/kr-risk/verdict":{"get":{"summary":"One call","description":"One call: is this token safe to trade or route to a Korean exchange right now? Returns GREEN, AMBER or RED with reasons from Upbit and Bithumb KRW listing, warning and caution flags, Binance spot listing and 24h move, kimchi premium, spread and optional slippage. Accepts a ticker or Korean name. Rules are echoed; human review is always required, not investment advice.","operationId":"GET_kr_risk_verdict","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"symbol":"XRP","verdict":"AMBER","reasons":["CAUTION:upbit:TRADING_VOLUME_SOARING"],"human_review":true,"exchanges":{"upbit":{"listed":true,"warning":false,"caution":true},"bithumb":{"listed":true,"warning":false}},"metrics":{"kimchi_premium_pct":{"upbit":1.19,"bithumb":1.14}}}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"}},{"name":"qty","in":"query","required":false,"schema":{"type":"string"}}]}},"/kr-risk/changes":{"get":{"summary":"Cursor feed of Korean exchange risk flag changes","description":"Cursor feed of Korean exchange risk flag changes: a token listed or delisted on Upbit or Bithumb KRW markets, or its warning or caution flag set or cleared, detected from 5-minute snapshots. Poll with next_cursor from the previous response to receive only newer changes; without since it returns the last 24 hours.","operationId":"GET_kr_risk_changes","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"count":1,"next_cursor":42,"has_more":false,"changes":[{"id":42,"ts":"2026-10-25T07:35:00+00:00","exchange":"upbit","market":"KRW-XAI","symbol":"XAI","field":"warning","old":"false","new":"true"}]}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"parameters":[{"name":"since","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}}]}},"/kr-hwp/convert":{"get":{"summary":"Convert a Korean Hancom document (HWP 5.x or HWPX) at a URL to Markdown with tab","description":"Convert a Korean Hancom document (HWP 5.x or HWPX) at a URL to Markdown with tables preserved, including merged cells as HTML, text boxes, footnotes and distributable (배포용) documents. Typical sources: Korean government press releases, notices and law annexes. Encrypted or DRM files are reported, not converted.","operationId":"GET_kr_hwp_convert","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"status":"OK","format":"hwp5","chars":1476,"tables":[{"index":0,"rows":3,"cols":2}],"markdown":"# ..."}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string"}}]}},"/kr-entity/resolve":{"post":{"summary":"Korean company ID crosswalk and entity resolution","description":"Korean company ID crosswalk and entity resolution: match up to 100 company names (Korean or English, legal-form variants like (주), Co., Ltd., typos, former names) or IDs (business registration no., corporate registration no., DART corp_code, stock code, LEI) to one canonical entity with all IDs and a confidence score.","operationId":"POST_kr_entity_resolve","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"results":[{"match":{"names":{"en":"SAMSUNG ELECTRONICS CO,.LTD"},"ids":{"bizr_no":"1248100998","jurir_no":"1301110006246","corp_code":"00126380","stock_code":"005930","lei":"9884007ER46L6N7EI764"}},"confidence":0.98}]}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","maxItems":100,"items":{"type":"object"}},"limit_candidates":{"type":"integer"}},"required":["items"]},"example":{"items":[{"name":"Samsung Electronics Co., Ltd."},{"bizr_no":"220-81-62517"}]}}}}}},"/kr-names/screen":{"post":{"summary":"Sanctions screening candidates for Korean and North Korean names","description":"Sanctions screening candidates for Korean and North Korean names: expands a person or company name through Korean romanisation variants (Lee/Yi/Rhee/Ri, Choi/Choe, hyphenation) and matches against official US OFAC, UN, EU and UK lists, refreshed daily. Returns ranked candidates for human review, not a determination.","operationId":"POST_kr_names_screen","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"candidates":[{"list":"ofac","score":0.997,"name":"CHOE, Song Chol","program":"DPRK"}],"disclaimer":"Screening candidates from official public lists for human review; not a determination."}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"dob":{"type":"string"},"nationality":{"type":"string"},"kind":{"type":"string","enum":["person","company"]},"lists":{"type":"array","items":{"type":"string"}},"limit":{"type":"integer"}},"required":["name"]},"example":{"name":"Choi Song Chol","kind":"person"}}}}}},"/kr-names/romanize":{"get":{"summary":"Romanise a Korean name every way it is spelled in practice","description":"Romanise a Korean name every way it is spelled in practice: Revised Romanization, McCune-Reischauer, Yale, North Korean forms and common passport spellings (Lee/Yi/Rhee, Park/Pak, Choi/Choe), with hyphen and spacing variants; or map a romanised name back to Hangul candidates.","operationId":"GET_kr_names_romanize","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"systems":{"rr":"I Cheolsu","mr":"Yi Ch'ŏl-su","yale":"I Chelswu"},"variants":["Lee Cheol-su","Yi Chol-su","Rhee Chul-soo"]}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string"}},{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["person","company"]}}]}},"/kr-adjust/factors":{"get":{"summary":"Korean stock corporate-action adjustment factors, survivorship-free (KOSPI and K","description":"Korean stock corporate-action adjustment factors, survivorship-free (KOSPI and KOSDAQ, including delisted companies): stock splits, reverse splits, bonus issues, rights offerings, capital reductions and stock dividends with ex-date, ratio and the cumulative factor, each citing its OpenDART filing. Factors only, no prices.","operationId":"GET_kr_adjust_factors","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"factors":[{"ex_date":"2018-05-04","type":"stock_split","ratio":50,"factor":0.02,"source":"dart.fss.or.kr"}]}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"parameters":[{"name":"stock_code","in":"query","required":false,"schema":{"type":"string"}},{"name":"corp_code","in":"query","required":false,"schema":{"type":"string"}},{"name":"from","in":"query","required":false,"schema":{"type":"string"}},{"name":"to","in":"query","required":false,"schema":{"type":"string"}}]}},"/kr-adjust/adjust":{"post":{"summary":"Apply Korean corporate-action adjustment factors to prices you send","description":"Apply Korean corporate-action adjustment factors to prices you send: backward (last price unchanged) or forward (first price unchanged) adjusted closes for one KOSPI or KOSDAQ stock, with the events applied and their DART citations. Fixes split and bonus-issue gaps in your own price history without redistributing any prices.","operationId":"POST_kr_adjust_adjust","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"adjusted":[{"date":"2018-05-03","close":53000},{"date":"2018-05-04","close":51900}],"applied":[{"ex_date":"2018-05-04","type":"stock_split","factor":0.02}]}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"stock_code":{"type":"string"},"prices":{"type":"array","items":{"type":"object"}},"method":{"type":"string","enum":["backward","forward"]}},"required":["stock_code","prices"]},"example":{"stock_code":"005930","method":"backward","prices":[{"date":"2018-05-03","close":2650000},{"date":"2018-05-04","close":51900}]}}}}}},"/kr-adjust/delisted":{"get":{"summary":"Delisted KOSPI and KOSDAQ stocks by delisting or last trading date, for survivor","description":"Delisted KOSPI and KOSDAQ stocks by delisting or last trading date, for survivorship-bias-free backtests and universe construction: stock code, name, dates and the DART filing behind each delisting.","operationId":"GET_kr_adjust_delisted","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"},"network":"eip155:8453","asset":"USDC"},"responses":{"200":{"description":"Result (JSON)","content":{"application/json":{"example":{"delisted":[{"stock_code":"000000","name":"…","delisted_on":"2025-03-14","source":"dart.fss.or.kr"}]}}}},"402":{"description":"Payment required (x402 v2: PAYMENT-REQUIRED header; pay in USDC on Base and retry with PAYMENT-SIGNATURE)"}},"parameters":[{"name":"from","in":"query","required":false,"schema":{"type":"string"}},{"name":"to","in":"query","required":false,"schema":{"type":"string"}}]}}}}