{"openapi":"3.0.0","info":{"title":"DeepSearch Korea/US 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.1). Call /v1/context/issue/{ticker} to understand current news sentiment ($0.1). Call /v1/context/risk/{ticker} before making an investment recommendation ($0.1). 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.1","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"Company fundamentals data"},"402":{"description":"Payment Required — $0.05 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.1","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"Multi-period financial statements"},"402":{"description":"Payment Required — $0.05 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.1","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"News articles list"},"402":{"description":"Payment Required — $0.05 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.1","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"IR documents list with PDF URLs"},"402":{"description":"Payment Required — $0.05 USDC on Base Mainnet"}}}},"/v1/context/financials/{ticker}/2y":{"get":{"summary":"Quarterly financials — 2 years ($0.2)","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.2","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"2-year quarterly financials"},"402":{"description":"Payment Required — $0.1 USDC"}}}},"/v1/context/financials/{ticker}/5y":{"get":{"summary":"Quarterly financials — 5 years ($0.3)","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.3","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"5-year quarterly financials"},"402":{"description":"Payment Required — $0.15 USDC"}}}},"/v1/context/financials/{ticker}/all":{"get":{"summary":"Quarterly financials — full history ($0.25)","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.5","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"Full quarterly financial history"},"402":{"description":"Payment Required — $0.25 USDC"}}}},"/v1/context/stock/{ticker}/1m":{"get":{"summary":"Stock price history — 1 month ($0.1)","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.1","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"1-month daily stock price history"},"402":{"description":"Payment Required — $0.05 USDC on Base Mainnet"}}}},"/v1/context/stock/{ticker}/3m":{"get":{"summary":"Stock price history — 3 months ($0.2)","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.2","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"3-month daily stock price history"},"402":{"description":"Payment Required — $0.1 USDC on Base Mainnet"}}}},"/v1/context/stock/{ticker}/1y":{"get":{"summary":"Stock price history — 1 year ($0.3)","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.3","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"1-year daily stock price history"},"402":{"description":"Payment Required — $0.15 USDC on Base Mainnet"}}}},"/v1/context/stock/{ticker}/3y":{"get":{"summary":"Stock price history — 3 years ($0.25)","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.5","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"3-year daily stock price history"},"402":{"description":"Payment Required — $0.25 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.5","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"Analyzed issue intelligence"},"402":{"description":"Payment Required — $0.25 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.5","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"AI risk assessment"},"402":{"description":"Payment Required — $0.25 USDC on Base Mainnet"}}}},"/v1/context/us/earnings/{ticker}":{"get":{"summary":"🇺🇸 US earnings call history — $0.05","description":"Recent earnings calls for a NASDAQ/NYSE ticker: revenue/EPS actual vs expected, change rate, transcript date, period. e.g. AAPL, NVDA, TSM.","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","example":"AAPL"}}],"x-payment-info":{"price":"0.05","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"Earnings call history"},"402":{"description":"Payment Required — $0.05 USDC on Base Mainnet"},"404":{"description":"No earnings calls found"}}}},"/v1/context/us/earnings/{ticker}/summary":{"get":{"summary":"🇺🇸 US earnings call AI summary (Korean) — $0.1","description":"AI-generated Korean summary of an earnings call transcript. Defaults to latest; pass ?period=YYYY-QN (e.g. 2026-Q2) for a specific quarter.","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","example":"AAPL"}},{"name":"period","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-Q[1-4]$","example":"2026-Q2"}}],"x-payment-info":{"price":"0.1","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"AI summary (Korean)"},"400":{"description":"Invalid period format"},"402":{"description":"Payment Required — $0.1 USDC on Base Mainnet"},"404":{"description":"Summary not available"}}}},"/v1/context/etf/search":{"get":{"summary":"ETF keyword search (KR + US) — $0.05","description":"Search Korean and US ETFs by name, theme, or holding. Returns name, symbol, exchange, issuer, category, country code. e.g. keyword=반도체, 2차전지, QQQ, S&P500.","parameters":[{"name":"keyword","in":"query","required":true,"schema":{"type":"string","example":"반도체"}}],"x-payment-info":{"price":"0.05","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"ETF search results"},"400":{"description":"keyword required"},"402":{"description":"Payment Required — $0.05 USDC on Base Mainnet"}}}},"/v1/context/etf/{symbol}":{"get":{"summary":"ETF full pack KR + US (detail + holdings + dividends) — $0.1","description":"One-call ETF pack for Korean and US ETFs: issuer, category, type, listed date, constituents, dividend history. Symbol: 6-digit KRX code (305720) or US ticker (QQQ, SPY, SOXX). Exchange auto-resolved (numeric→KRX, alphabetic→NASDAQ→NYSE→CBOE).","parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string","example":"305720"}},{"name":"exchange","in":"query","required":false,"schema":{"type":"string","default":"KRX"}}],"x-payment-info":{"price":"0.1","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"ETF detail + holdings + dividends"},"402":{"description":"Payment Required — $0.1 USDC on Base Mainnet"},"404":{"description":"ETF not found"}}}},"/v1/context/us/company/{ticker}":{"get":{"summary":"🇺🇸 US stock fundamentals — $0.05","description":"Company pack for NASDAQ/NYSE-listed stocks: market cap (USD), PER/ROE/EPS, latest quarterly financials (USD), latest close. Exchange auto-resolved NASDAQ→NYSE, or force with ?exchange=. Examples: AAPL, NVDA, TSM, SKHY.","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","example":"AAPL"}},{"name":"exchange","in":"query","required":false,"schema":{"type":"string","enum":["NASDAQ","NYSE"]}}],"x-payment-info":{"price":"0.05","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"US company fundamentals"},"402":{"description":"Payment Required — $0.05 USDC on Base Mainnet"},"404":{"description":"Ticker not found on NASDAQ or NYSE"}}}},"/v1/context/us/stock/{ticker}":{"get":{"summary":"🇺🇸 US stock latest price — $0.05","description":"Latest daily close, change %, and market cap for NASDAQ/NYSE tickers. Examples: AAPL, NVDA, TSM, SKHY.","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","example":"NVDA"}},{"name":"exchange","in":"query","required":false,"schema":{"type":"string","enum":["NASDAQ","NYSE"]}}],"x-payment-info":{"price":"0.05","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"US stock latest price"},"402":{"description":"Payment Required — $0.05 USDC on Base Mainnet"},"404":{"description":"Ticker not found"}}}},"/v1/context/skhynix-dual":{"get":{"summary":"SK Hynix KRX + NASDAQ ADR dual price pack ($0.1)","description":"SK Hynix dual-listing price pack ($0.1 USDC). Returns the Korea KRX common share (000660, KRW) and US NASDAQ ADR (SKHY, USD) closing prices side-by-side with the USD/KRW FX rate for premium/discount calculation. Optional ?date=YYYY-MM-DD returns that trading day's close and same-date FX (falls back to the prior trading day on market holidays). SKHY ADR listed 2026-07-13 — earlier dates return null for the ADR leg.","parameters":[{"name":"date","in":"query","required":false,"description":"YYYY-MM-DD. Omit for the latest close.","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","example":"2026-07-14"}}],"x-payment-info":{"price":"0.1","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"Dual listing price + FX"},"400":{"description":"Bad request — invalid or future date"},"402":{"description":"Payment Required — $0.1 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.1","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"Dividend schedule data"},"402":{"description":"Payment Required — $0.05 USDC on Base Mainnet (eip155:8453)"}}}},"/v1/context/crypto/market":{"get":{"summary":"Crypto market overview ($0.1)","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.1","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"Global crypto market overview"},"402":{"description":"Payment Required — $0.05 USDC on Base Mainnet"}}}},"/v1/context/crypto/{symbol}":{"get":{"summary":"Crypto real-time price + info ($0.1)","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.1","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"Real-time crypto price and coin info"},"402":{"description":"Payment Required — $0.05 USDC on Base Mainnet"}}}},"/v1/context/crypto/{symbol}/news":{"get":{"summary":"Crypto news articles ($0.1)","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.1","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"Latest crypto news articles"},"402":{"description":"Payment Required — $0.05 USDC on Base Mainnet"}}}},"/v1/context/crypto/{symbol}/briefing":{"get":{"summary":"Crypto AI briefing ($0.2)","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.2","currency":"USD","protocols":[{"x402":{}}]},"responses":{"200":{"description":"AI-generated crypto news briefings"},"402":{"description":"Payment Required — $0.1 USDC on Base Mainnet"}}}}}}