{"openapi":"3.1.0","info":{"title":"KR Crypto Intelligence API","description":"Korean crypto market data + AI sentiment for AI agents. Kimchi premium, exchange intelligence, sentiment analysis.","version":"0.1.0","x-guidance":"Korean crypto market + news data API for AI agents. Use GET /api/v1/kimchi-premium for single-token Kimchi Premium. Use GET /api/v1/kr-sentiment for Korean market sentiment in English. Use GET /api/v1/kr-news/kpop for K-pop news translated to English. Use GET /api/v1/kr-news/semiconductor for Korean semiconductor industry news. All paid endpoints require x402 payment ($0.001-$0.10 USDC). Networks: Base, Polygon, Solana. Every paid response includes signed receipt (ECDSA secp256k1) for agent accountability."},"paths":{"/":{"get":{"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"x-auth-mode":"none"}},"/.well-known/x402":{"get":{"summary":"X402 Manifest","description":"x402 service discovery manifest.","operationId":"x402_manifest__well_known_x402_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"x-auth-mode":"none"}},"/llms.txt":{"get":{"summary":"Llms Txt","operationId":"llms_txt_llms_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}},"security":[],"x-auth-mode":"none"}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"x-auth-mode":"none"}},"/api/v1/symbols":{"get":{"summary":"Symbols","operationId":"symbols_api_v1_symbols_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"x-auth-mode":"none"}},"/api/v1/kimchi-premium":{"get":{"summary":"Kimchi Premium","operationId":"kimchi_premium_api_v1_kimchi_premium_get","parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string","description":"Crypto symbol (e.g., BTC, ETH, XRP)","default":"BTC","title":"Symbol"},"description":"Crypto symbol (e.g., BTC, ETH, XRP)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"accepts":{"type":"array"},"x402Version":{"type":"integer"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001000"},"protocols":[{"x402":{}}]}}},"/api/v1/stablecoin-premium":{"get":{"summary":"Stablecoin Premium","operationId":"stablecoin_premium_api_v1_stablecoin_premium_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"accepts":{"type":"array"},"x402Version":{"type":"integer"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001000"},"protocols":[{"x402":{}}]}}},"/api/v1/kr-prices":{"get":{"summary":"Kr Prices","operationId":"kr_prices_api_v1_kr_prices_get","parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string","description":"Crypto symbol","default":"BTC","title":"Symbol"},"description":"Crypto symbol"},{"name":"exchange","in":"query","required":false,"schema":{"type":"string","description":"Exchange: upbit, bithumb, or all","default":"all","title":"Exchange"},"description":"Exchange: upbit, bithumb, or all"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"accepts":{"type":"array"},"x402Version":{"type":"integer"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001000"},"protocols":[{"x402":{}}]}}},"/api/v1/fx-rate":{"get":{"summary":"Fx Rate Endpoint","operationId":"fx_rate_endpoint_api_v1_fx_rate_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"accepts":{"type":"array"},"x402Version":{"type":"integer"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001000"},"protocols":[{"x402":{}}]}}},"/api/v1/stats":{"get":{"summary":"Get Stats","operationId":"get_stats_api_v1_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[],"x-auth-mode":"none"}},"/api/v1/kr-sentiment":{"get":{"summary":"Kr Sentiment Endpoint","description":"Korean crypto market sentiment — AI analysis combining exchange data + Korean news.","operationId":"kr_sentiment_endpoint_api_v1_kr_sentiment_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"accepts":{"type":"array"},"x402Version":{"type":"integer"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]}}},"/api/v1/arbitrage-scanner":{"get":{"summary":"Arbitrage Scanner","description":"Token-by-token Kimchi Premium, reverse premium, Upbit-Bithumb gap, market share","operationId":"arbitrage_scanner_api_v1_arbitrage_scanner_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"accepts":{"type":"array"},"x402Version":{"type":"integer"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]}}},"/api/v1/exchange-alerts":{"get":{"summary":"Exchange Alerts","description":"Listing changes, caution/warning tokens","operationId":"exchange_alerts_api_v1_exchange_alerts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"accepts":{"type":"array"},"x402Version":{"type":"integer"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]}}},"/api/v1/market-movers":{"get":{"summary":"Market Movers","description":"Volume spikes, price surges/crashes, top volume tokens","operationId":"market_movers_api_v1_market_movers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"accepts":{"type":"array"},"x402Version":{"type":"integer"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]}}},"/api/v1/market-read":{"get":{"summary":"Market Read","description":"AI-powered Korean crypto market analysis.","operationId":"market_read_api_v1_market_read_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"accepts":{"type":"array"},"x402Version":{"type":"integer"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]}}},"/api/v1/global-vs-korea-divergence":{"get":{"summary":"Global Vs Korea Divergence","description":"Light tier — divergence + 1-2 sentence AI summary. $0.05.","operationId":"global_vs_korea_divergence_api_v1_global_vs_korea_divergence_get","parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string","description":"Crypto symbol (e.g., BTC, ETH, XRP)","default":"BTC","title":"Symbol"},"description":"Crypto symbol (e.g., BTC, ETH, XRP)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"accepts":{"type":"array"},"x402Version":{"type":"integer"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]}}},"/api/v1/global-vs-korea-divergence-deep":{"get":{"summary":"Global Vs Korea Divergence Deep","description":"Deep tier — light data + Korean news signal + structured AI analysis. $0.10.","operationId":"global_vs_korea_divergence_deep_api_v1_global_vs_korea_divergence_deep_get","parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string","description":"Crypto symbol (e.g., BTC, ETH, XRP)","default":"BTC","title":"Symbol"},"description":"Crypto symbol (e.g., BTC, ETH, XRP)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"accepts":{"type":"array"},"x402Version":{"type":"integer"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]}}},"/api/v1/kr-news/kpop":{"get":{"summary":"Kr News Kpop","description":"Korean K-pop news (Naver) → English translation + AI relevance classification. $0.01.","operationId":"kr_news_kpop_api_v1_kr_news_kpop_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":10,"minimum":1,"description":"Number of articles to return (1-10)","default":5,"title":"Limit"},"description":"Number of articles to return (1-10)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"accepts":{"type":"array"},"x402Version":{"type":"integer"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]}}},"/api/v1/kr-news/kpop-summary":{"get":{"summary":"Kr News Kpop Summary","description":"Korean K-pop news + AI synthesis (sentiment, key themes, trending artists). $0.05.","operationId":"kr_news_kpop_summary_api_v1_kr_news_kpop_summary_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":10,"minimum":1,"description":"Number of articles to analyze (1-10)","default":5,"title":"Limit"},"description":"Number of articles to analyze (1-10)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"accepts":{"type":"array"},"x402Version":{"type":"integer"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]}}},"/api/v1/kr-news/semiconductor":{"get":{"summary":"Kr News Semiconductor","description":"Korean semiconductor industry news (Naver) → English translation. Samsung/SK Hynix/HBM. $0.02.","operationId":"kr_news_semiconductor_api_v1_kr_news_semiconductor_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":10,"minimum":1,"description":"Number of articles to return (1-10)","default":5,"title":"Limit"},"description":"Number of articles to return (1-10)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"accepts":{"type":"array"},"x402Version":{"type":"integer"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]}}},"/api/v1/kr-news/semiconductor-summary":{"get":{"summary":"Kr News Semiconductor Summary","description":"Korean semiconductor news + AI market synthesis (sentiment, themes, market_signal). $0.10.","operationId":"kr_news_semiconductor_summary_api_v1_kr_news_semiconductor_summary_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":10,"minimum":1,"description":"Number of articles to analyze (1-10)","default":5,"title":"Limit"},"description":"Number of articles to analyze (1-10)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"accepts":{"type":"array"},"x402Version":{"type":"integer"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"x-discovery":{"ownershipProofs":[]}}