{"openapi":"3.0.0","info":{"title":"DeepSearch Korean Stock Intelligence API","version":"1.0.0","description":"Up to 10 years of financials + 3 years of daily price history for all 2,000+ KRX stocks. Pay-per-query with USDC on Base Mainnet — no subscription.","x-logo":{"url":"https://deepsearch.com/icons/icon-deepsearch.svg","altText":"DeepSearch"},"x-guidance":"This API provides Korean stock market intelligence packs for AI agents. Call /v1/context/company/{ticker} first for valuation and financials ($0.01). Call /v1/context/issue/{ticker} to understand current news sentiment ($0.01). Call /v1/context/risk/{ticker} before making an investment recommendation ($0.01). Ticker accepts a 6-digit KRX code OR company name in English or Korean (e.g. 005930, samsung, 삼성전자 all resolve to Samsung Electronics). Payment is handled automatically via x402 protocol — send a USDC micropayment on Base Mainnet (eip155:8453) when you receive a 402 response."},"servers":[{"url":"https://x402.deepsearch.com"}],"paths":{"/v1/context/company/{ticker}":{"get":{"summary":"Company fundamentals pack","description":"Real-time company fundamentals: market cap, PER, PBR, ROE, revenue, operating profit, net income, debt ratio, and latest stock price. Use for valuation and financial overview.","parameters":[{"name":"ticker","in":"path","required":true,"description":"6-digit KRX ticker code. e.g. 005930 (Samsung Electronics), 000660 (SK Hynix)","schema":{"type":"string","example":"005930"}},{"name":"exchange","in":"query","required":false,"description":"Exchange code. Default: KRX","schema":{"type":"string","default":"KRX"}}],"x-payment-info":{"price":"0.01","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"Company fundamentals data"},"402":{"description":"Payment Required — $0.005 USDC on Base Mainnet (eip155:8453)"}}}},"/v1/context/financials/{ticker}":{"get":{"summary":"Multi-period financial statements pack","description":"Up to 8 quarters of financial statements: revenue, gross profit, operating profit, net income, total assets, liabilities, and equity. Available for both KRX and US-listed companies. Use when an agent needs historical financial trends or year-over-year comparisons.","parameters":[{"name":"ticker","in":"path","required":true,"description":"KRX ticker (e.g. 005930) or US symbol (e.g. AAPL)","schema":{"type":"string","example":"005930"}},{"name":"exchange","in":"query","required":false,"description":"Exchange: KRX (default), NASDAQ, NYSE","schema":{"type":"string","default":"KRX"}}],"x-payment-info":{"price":"0.01","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"Multi-period financial statements"},"402":{"description":"Payment Required — $0.005 USDC on Base Mainnet"}}}},"/v1/context/news/{ticker}":{"get":{"summary":"Raw news articles pack","description":"Latest news articles from the past 14 days for a KRX-listed company. Returns title, summary, publisher, publication date, and article URL. Use when you need the actual source articles rather than an AI-analyzed summary.","parameters":[{"name":"ticker","in":"path","required":true,"description":"6-digit KRX ticker code","schema":{"type":"string","example":"005930"}},{"name":"exchange","in":"query","required":false,"schema":{"type":"string","default":"KRX"}}],"x-payment-info":{"price":"0.01","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"News articles list"},"402":{"description":"Payment Required — $0.005 USDC on Base Mainnet"}}}},"/v1/context/ir/{ticker}":{"get":{"summary":"IR documents pack","description":"Official IR documents published by the company: earnings announcements, corporate briefings, investor presentations. Returns title, published date, and PDF URL. KRX-listed companies only.","parameters":[{"name":"ticker","in":"path","required":true,"description":"6-digit KRX ticker code","schema":{"type":"string","example":"005930"}},{"name":"exchange","in":"query","required":false,"schema":{"type":"string","default":"KRX"}}],"x-payment-info":{"price":"0.01","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"IR documents list with PDF URLs"},"402":{"description":"Payment Required — $0.005 USDC on Base Mainnet"}}}},"/v1/context/financials/{ticker}/2y":{"get":{"summary":"Quarterly financials — 2 years ($0.02)","description":"2-year quarterly financial history (~8 quarters): revenue, gross profit, operating profit, net income, total assets, equity. Use for year-over-year comparisons and trend analysis.","parameters":[{"name":"ticker","in":"path","required":true,"description":"6-digit KRX ticker or US symbol","schema":{"type":"string","example":"005930"}},{"name":"exchange","in":"query","required":false,"schema":{"type":"string","default":"KRX"}}],"x-payment-info":{"price":"0.02","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"2-year quarterly financials"},"402":{"description":"Payment Required — $0.01 USDC"}}}},"/v1/context/financials/{ticker}/5y":{"get":{"summary":"Quarterly financials — 5 years ($0.03)","description":"5-year quarterly financial history (~20 quarters). Use for medium-term profitability analysis, business cycle assessment.","parameters":[{"name":"ticker","in":"path","required":true,"description":"6-digit KRX ticker or US symbol","schema":{"type":"string","example":"005930"}},{"name":"exchange","in":"query","required":false,"schema":{"type":"string","default":"KRX"}}],"x-payment-info":{"price":"0.03","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"5-year quarterly financials"},"402":{"description":"Payment Required — $0.015 USDC"}}}},"/v1/context/financials/{ticker}/all":{"get":{"summary":"Quarterly financials — full history ($0.025)","description":"Full available quarterly financial history (33+ quarters, back to 2018). Use for long-term analysis, business cycle research, multi-year CAGR calculations.","parameters":[{"name":"ticker","in":"path","required":true,"description":"6-digit KRX ticker or US symbol","schema":{"type":"string","example":"005930"}},{"name":"exchange","in":"query","required":false,"schema":{"type":"string","default":"KRX"}}],"x-payment-info":{"price":"0.05","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"Full quarterly financial history"},"402":{"description":"Payment Required — $0.025 USDC"}}}},"/v1/context/stock/{ticker}/1m":{"get":{"summary":"Stock price history — 1 month ($0.01)","description":"Daily closing prices for the past 1 month (~22 trading days). Returns close price, change %, market cap per day, plus period high/low and total return. Use for short-term trend analysis.","parameters":[{"name":"ticker","in":"path","required":true,"description":"6-digit KRX ticker (e.g. 005930) or US symbol","schema":{"type":"string","example":"005930"}},{"name":"exchange","in":"query","required":false,"description":"Exchange: KRX (default), NASDAQ, NYSE","schema":{"type":"string","default":"KRX"}}],"x-payment-info":{"price":"0.01","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"1-month daily stock price history"},"402":{"description":"Payment Required — $0.005 USDC on Base Mainnet"}}}},"/v1/context/stock/{ticker}/3m":{"get":{"summary":"Stock price history — 3 months ($0.02)","description":"Daily closing prices for the past 3 months (~65 trading days). Returns close price, change %, market cap per day, plus period high/low and total return. Use for quarterly trend analysis.","parameters":[{"name":"ticker","in":"path","required":true,"description":"6-digit KRX ticker or US symbol","schema":{"type":"string","example":"005930"}},{"name":"exchange","in":"query","required":false,"schema":{"type":"string","default":"KRX"}}],"x-payment-info":{"price":"0.02","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"3-month daily stock price history"},"402":{"description":"Payment Required — $0.01 USDC on Base Mainnet"}}}},"/v1/context/stock/{ticker}/1y":{"get":{"summary":"Stock price history — 1 year ($0.03)","description":"Daily closing prices for the past 1 year (~252 trading days). Returns close price, change %, market cap per day, plus period high/low and total return. Use for annual trend analysis, 52-week high/low calculations.","parameters":[{"name":"ticker","in":"path","required":true,"description":"6-digit KRX ticker or US symbol","schema":{"type":"string","example":"005930"}},{"name":"exchange","in":"query","required":false,"schema":{"type":"string","default":"KRX"}}],"x-payment-info":{"price":"0.03","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"1-year daily stock price history"},"402":{"description":"Payment Required — $0.015 USDC on Base Mainnet"}}}},"/v1/context/stock/{ticker}/3y":{"get":{"summary":"Stock price history — 3 years ($0.025)","description":"Daily closing prices for the past 3 years (~780 trading days). Returns close price, change %, market cap per day, plus period high/low and total return. Use for long-term trend analysis, multi-year comparisons.","parameters":[{"name":"ticker","in":"path","required":true,"description":"6-digit KRX ticker or US symbol","schema":{"type":"string","example":"005930"}},{"name":"exchange","in":"query","required":false,"schema":{"type":"string","default":"KRX"}}],"x-payment-info":{"price":"0.05","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"3-year daily stock price history"},"402":{"description":"Payment Required — $0.025 USDC on Base Mainnet"}}}},"/v1/context/issue/{ticker}":{"get":{"summary":"AI-analyzed issue intelligence pack","description":"DeepSearch AI-analyzed news-driven issues from the last 30 days. Returns ranked issues with sentiment scoring (positive/negative/neutral), relevance score, and publication date. Includes proprietary sentiment analysis.","parameters":[{"name":"ticker","in":"path","required":true,"description":"6-digit KRX ticker code","schema":{"type":"string","example":"005930"}},{"name":"exchange","in":"query","required":false,"schema":{"type":"string","default":"KRX"}}],"x-payment-info":{"price":"0.05","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"Analyzed issue intelligence"},"402":{"description":"Payment Required — $0.025 USDC on Base Mainnet"}}}},"/v1/context/risk/{ticker}":{"get":{"summary":"AI risk assessment pack","description":"DeepSearch AI investment risk assessment derived from 60 days of news and regulatory filings. Returns overall risk level (high/medium/low), categorized risk factors (financial, legal, operational, market), and mitigating signals.","parameters":[{"name":"ticker","in":"path","required":true,"description":"6-digit KRX ticker code","schema":{"type":"string","example":"005930"}},{"name":"exchange","in":"query","required":false,"schema":{"type":"string","default":"KRX"}}],"x-payment-info":{"price":"0.05","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"AI risk assessment"},"402":{"description":"Payment Required — $0.025 USDC on Base Mainnet"}}}},"/v1/context/dividend/{ticker}":{"get":{"summary":"Dividend schedule pack","description":"Latest and upcoming dividend schedule for a KRX-listed company. Returns ex-dividend date, payment date, dividend amount (KRW per share), and whether the figure is a forecast. Use when an investor asks about dividend yield, payout dates, or income potential.","parameters":[{"name":"ticker","in":"path","required":true,"description":"6-digit KRX ticker code","schema":{"type":"string","example":"005930"}},{"name":"exchange","in":"query","required":false,"schema":{"type":"string","default":"KRX"}}],"x-payment-info":{"price":"0.01","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"Dividend schedule data"},"402":{"description":"Payment Required — $0.005 USDC on Base Mainnet (eip155:8453)"}}}},"/v1/context/crypto/market":{"get":{"summary":"Crypto market overview ($0.01)","description":"Global crypto market overview: total market cap (USD/KRW), BTC dominance (global + Korea), and top 5 coins by gain ratio, loss ratio, and trading value. Updated every 10 minutes.","parameters":[],"x-payment-info":{"price":"0.01","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"Global crypto market overview"},"402":{"description":"Payment Required — $0.005 USDC on Base Mainnet"}}}},"/v1/context/crypto/{symbol}":{"get":{"summary":"Crypto real-time price + info ($0.01)","description":"Real-time cryptocurrency price and coin info. Returns current price (KRW), change rate, kimchi premium, daily high/low/open, accumulated trading value, market cap, circulating supply, and coin profile. Supports BTC, ETH, XRP, SOL, DOGE, and all coins listed on Korean exchanges.","parameters":[{"name":"symbol","in":"path","required":true,"description":"Coin symbol e.g. BTC, ETH, XRP, SOL, DOGE","schema":{"type":"string","example":"BTC"}}],"x-payment-info":{"price":"0.01","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"Real-time crypto price and coin info"},"402":{"description":"Payment Required — $0.005 USDC on Base Mainnet"}}}},"/v1/context/crypto/{symbol}/news":{"get":{"summary":"Crypto news articles ($0.01)","description":"Latest news articles for a cryptocurrency. Returns up to 10 recent news items with title, press name, published date, and article URL.","parameters":[{"name":"symbol","in":"path","required":true,"description":"Coin symbol e.g. BTC, ETH, XRP","schema":{"type":"string","example":"BTC"}}],"x-payment-info":{"price":"0.01","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"Latest crypto news articles"},"402":{"description":"Payment Required — $0.005 USDC on Base Mainnet"}}}},"/v1/context/crypto/{symbol}/briefing":{"get":{"summary":"Crypto AI briefing ($0.02)","description":"DeepSearch AI-generated news briefings for a cryptocurrency. Summarizes recent news into concise, insight-rich briefings. Returns up to 5 latest AI briefings with source article links.","parameters":[{"name":"symbol","in":"path","required":true,"description":"Coin symbol e.g. BTC, ETH, XRP","schema":{"type":"string","example":"BTC"}}],"x-payment-info":{"price":"0.02","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"AI-generated crypto news briefings"},"402":{"description":"Payment Required — $0.01 USDC on Base Mainnet"}}}}}}