{"openapi":"3.1.0","info":{"title":"x402stock","description":"Real-time US stock market data for AI agents. No API keys, no accounts. Pay per request in USDC via x402 or MPP.","version":"1.0.0","x-guidance":"All endpoints are under /api/v1 and return JSON shaped { ticker, data, source: 'x402stock', as_of }.\nPaid endpoints charge USDC per request via x402 or MPP (no API keys, no accounts). An unpaid request to a paid endpoint returns HTTP 402 with payment requirements; pay and retry. Free endpoints return 200 directly.\nWhere a path contains {ticker}, pass a US-listed ticker symbol in uppercase (e.g. AAPL).\n\nEndpoints (price per request):\n- /api/v1/overview/{ticker} ($0.05): Everything about one stock in one call: profile, price, fundamentals, technicals, news, peers\n- /api/v1/compare ($0.05): Compare 2 to 3 stocks side by side: price, P/E, market cap, margins, yield\n- /api/v1/technicals/{ticker} ($0.03): Technical indicators in one call: RSI, SMA, EMA, MACD with signal zones\n- /api/v1/market-pulse ($0.03): Market movers in one call: top gainers, top losers, market status, news\n- /api/v1/quote/{ticker} ($0.01): Last price for a US stock, 15 minute delayed\n- /api/v1/snapshot/{ticker} ($0.01): Full ticker snapshot (last quote, last trade, OHLC, prev close, %change)\n- /api/v1/aggregates/{ticker} ($0.02): Historical price history: OHLC bars over any timespan and date range\n- /api/v1/news ($0.02): Latest news articles, optionally filtered by ticker\n- /api/v1/ticker/{ticker} ($0.01): Company / ticker reference data\n- /api/v1/prev-close/{ticker} ($0.01): Previous trading day OHLC bar\n- /api/v1/open-close/{ticker} ($0.01): Daily open/close (+ pre/after-hours) for a specific date\n- /api/v1/dividends/{ticker} ($0.01): Dividend history (cash amount, ex-date, pay date, frequency)\n- /api/v1/splits/{ticker} ($0.01): Stock split history\n- /api/v1/financials/{ticker} ($0.02): Fundamentals: income, balance sheet, and cash flow statements\n- /api/v1/events/{ticker} ($0.01): Corporate events (ticker changes and more)\n- /api/v1/related/{ticker} ($0.01): Related peer companies\n- /api/v1/indicators/sma/{ticker} ($0.01): Simple Moving Average (SMA)\n- /api/v1/indicators/ema/{ticker} ($0.01): Exponential Moving Average (EMA)\n- /api/v1/indicators/rsi/{ticker} ($0.01): Relative Strength Index (RSI)\n- /api/v1/indicators/macd/{ticker} ($0.01): Moving Average Convergence/Divergence (MACD)\n- /api/v1/gainers ($0.02): Top gaining US stocks today\n- /api/v1/losers ($0.02): Top losing US stocks today\n- /api/v1/grouped-daily ($0.02): Whole-market daily OHLC for one date\n- /api/v1/full-market-snapshot ($0.04): Whole-market snapshot: every US ticker's current price and day change in one call\n- /api/v1/unified-snapshot ($0.02): Multi-ticker snapshot: fetch a whole watchlist's prices in one call\n- /api/v1/options/{ticker} ($0.02): Options chain for a US stock: every contract with strike, expiration, and call/put type\n- /api/v1/options-aggregates/{contract} ($0.02): Historical OHLC bars for a single option contract\n- /api/v1/short-interest/{ticker} ($0.02): Bi-weekly short interest and days-to-cover for a stock\n- /api/v1/short-volume/{ticker} ($0.02): Daily short-sale volume and short-volume ratio for a stock\n- /api/v1/ipos ($0.02): IPO calendar: upcoming and historical US listings with price range and size\n- /api/v1/forex/{pair}/aggregates ($0.02): Forex price history: OHLC bars for a currency pair over any timespan and date range\n- /api/v1/forex/{pair}/prev-close ($0.01): Previous day OHLC bar for a currency pair\n- /api/v1/crypto/{pair}/aggregates ($0.02): Crypto price history: OHLC bars for a spot pair over any timespan and date range\n- /api/v1/crypto/{pair}/prev-close ($0.01): Previous UTC-day OHLC candle for a crypto spot pair\n- /api/v1/crypto/{pair}/open-close ($0.01): Daily open and close for a crypto spot pair on a specific date\n- /api/v1/screener ($0.03): Screen the whole US market: filter every ticker by price, percent move, and volume in one call\n- /api/v1/exchanges ($0.01): US stock exchanges & market centers reference\n- /api/v1/conditions ($0.01): Trade & quote condition codes reference\n- /api/v1/ticker-types ($0.01): Ticker type codes reference (CS, ETF, ADRC, …)\n- /api/v1/tickers ($0.01): Search / list tickers across stocks, crypto, forex, and indices\n- /api/v1/filings/{ticker} ($0.01): SEC filing history for a company: 10-K, 10-Q, 8-K, Form 4, and more\n- /api/v1/insider-trades/{ticker} ($0.03): Insider transactions from SEC Form 4: who bought or sold, how much, at what price\n- /api/v1/material-events/{ticker} ($0.03): Material corporate events from 8-K filings, classified by SEC item code\n- /api/v1/concept/{ticker} ($0.02): Time series of a single XBRL financial fact straight from SEC filings\n- /api/v1/company-facts/{ticker} ($0.02): Every reported financial fact for a company, latest value each, straight from SEC XBRL\n- /api/v1/filing-summary/{ticker} ($0.03): AI-structured summary of a 10-K, 10-Q, or 8-K: overview, risk factors, MD&A, guidance\n- /api/v1/filing-search ($0.02): Full-text search across all SEC filings since 2001 by keyword, form type, and date\n- /api/v1/frames ($0.02): Compare one financial metric across every public company for a single period\n- /api/v1/form-3/{ticker} ($0.02): Initial insider ownership from SEC Form 3: holdings reported when an insider role begins\n- /api/v1/fund-holdings/{cik} ($0.03): Institutional 13F holdings for a fund by CIK: every position, value, and shares\n- /api/v1/fails-to-deliver/{ticker} ($0.02): Fails-to-deliver history for a stock: settlement-fail share volume by date\n- /api/v1/congress-trades ($0.03): US congressional stock trades (House & Senate) from STOCK Act disclosures: who traded what, when, and how much\n- /api/v1/treasury-yields ($0.01): US Treasury par yield curve (1mo to 30yr) for the latest day or a date range\n- /api/v1/inflation ($0.02): US CPI inflation: headline and core index with year-over-year percent\n- /api/v1/labor-market ($0.02): US labor market: unemployment, participation, payrolls, and wage growth\n- /api/v1/trending/reddit ($0.01): Trending tickers on Reddit (last 24h): the most-mentioned stocks, crypto, or both\n- /api/v1/trending/4chan ($0.01): Trending tickers on 4chan /biz/ (last 24h): the most-mentioned by post volume\n- /api/v1/market-status (free): Current US market status (open / closed / pre / post)\n- /api/v1/market-holidays (free): Upcoming US market holidays & early closes\n\nMachine-readable spec: /openapi.json. Payable resource catalog: /.well-known/x402 (also /.well-known/x402.json).","guidance":"All endpoints are under /api/v1 and return JSON shaped { ticker, data, source: 'x402stock', as_of }.\nPaid endpoints charge USDC per request via x402 or MPP (no API keys, no accounts). An unpaid request to a paid endpoint returns HTTP 402 with payment requirements; pay and retry. Free endpoints return 200 directly.\nWhere a path contains {ticker}, pass a US-listed ticker symbol in uppercase (e.g. AAPL).\n\nEndpoints (price per request):\n- /api/v1/overview/{ticker} ($0.05): Everything about one stock in one call: profile, price, fundamentals, technicals, news, peers\n- /api/v1/compare ($0.05): Compare 2 to 3 stocks side by side: price, P/E, market cap, margins, yield\n- /api/v1/technicals/{ticker} ($0.03): Technical indicators in one call: RSI, SMA, EMA, MACD with signal zones\n- /api/v1/market-pulse ($0.03): Market movers in one call: top gainers, top losers, market status, news\n- /api/v1/quote/{ticker} ($0.01): Last price for a US stock, 15 minute delayed\n- /api/v1/snapshot/{ticker} ($0.01): Full ticker snapshot (last quote, last trade, OHLC, prev close, %change)\n- /api/v1/aggregates/{ticker} ($0.02): Historical price history: OHLC bars over any timespan and date range\n- /api/v1/news ($0.02): Latest news articles, optionally filtered by ticker\n- /api/v1/ticker/{ticker} ($0.01): Company / ticker reference data\n- /api/v1/prev-close/{ticker} ($0.01): Previous trading day OHLC bar\n- /api/v1/open-close/{ticker} ($0.01): Daily open/close (+ pre/after-hours) for a specific date\n- /api/v1/dividends/{ticker} ($0.01): Dividend history (cash amount, ex-date, pay date, frequency)\n- /api/v1/splits/{ticker} ($0.01): Stock split history\n- /api/v1/financials/{ticker} ($0.02): Fundamentals: income, balance sheet, and cash flow statements\n- /api/v1/events/{ticker} ($0.01): Corporate events (ticker changes and more)\n- /api/v1/related/{ticker} ($0.01): Related peer companies\n- /api/v1/indicators/sma/{ticker} ($0.01): Simple Moving Average (SMA)\n- /api/v1/indicators/ema/{ticker} ($0.01): Exponential Moving Average (EMA)\n- /api/v1/indicators/rsi/{ticker} ($0.01): Relative Strength Index (RSI)\n- /api/v1/indicators/macd/{ticker} ($0.01): Moving Average Convergence/Divergence (MACD)\n- /api/v1/gainers ($0.02): Top gaining US stocks today\n- /api/v1/losers ($0.02): Top losing US stocks today\n- /api/v1/grouped-daily ($0.02): Whole-market daily OHLC for one date\n- /api/v1/full-market-snapshot ($0.04): Whole-market snapshot: every US ticker's current price and day change in one call\n- /api/v1/unified-snapshot ($0.02): Multi-ticker snapshot: fetch a whole watchlist's prices in one call\n- /api/v1/options/{ticker} ($0.02): Options chain for a US stock: every contract with strike, expiration, and call/put type\n- /api/v1/options-aggregates/{contract} ($0.02): Historical OHLC bars for a single option contract\n- /api/v1/short-interest/{ticker} ($0.02): Bi-weekly short interest and days-to-cover for a stock\n- /api/v1/short-volume/{ticker} ($0.02): Daily short-sale volume and short-volume ratio for a stock\n- /api/v1/ipos ($0.02): IPO calendar: upcoming and historical US listings with price range and size\n- /api/v1/forex/{pair}/aggregates ($0.02): Forex price history: OHLC bars for a currency pair over any timespan and date range\n- /api/v1/forex/{pair}/prev-close ($0.01): Previous day OHLC bar for a currency pair\n- /api/v1/crypto/{pair}/aggregates ($0.02): Crypto price history: OHLC bars for a spot pair over any timespan and date range\n- /api/v1/crypto/{pair}/prev-close ($0.01): Previous UTC-day OHLC candle for a crypto spot pair\n- /api/v1/crypto/{pair}/open-close ($0.01): Daily open and close for a crypto spot pair on a specific date\n- /api/v1/screener ($0.03): Screen the whole US market: filter every ticker by price, percent move, and volume in one call\n- /api/v1/exchanges ($0.01): US stock exchanges & market centers reference\n- /api/v1/conditions ($0.01): Trade & quote condition codes reference\n- /api/v1/ticker-types ($0.01): Ticker type codes reference (CS, ETF, ADRC, …)\n- /api/v1/tickers ($0.01): Search / list tickers across stocks, crypto, forex, and indices\n- /api/v1/filings/{ticker} ($0.01): SEC filing history for a company: 10-K, 10-Q, 8-K, Form 4, and more\n- /api/v1/insider-trades/{ticker} ($0.03): Insider transactions from SEC Form 4: who bought or sold, how much, at what price\n- /api/v1/material-events/{ticker} ($0.03): Material corporate events from 8-K filings, classified by SEC item code\n- /api/v1/concept/{ticker} ($0.02): Time series of a single XBRL financial fact straight from SEC filings\n- /api/v1/company-facts/{ticker} ($0.02): Every reported financial fact for a company, latest value each, straight from SEC XBRL\n- /api/v1/filing-summary/{ticker} ($0.03): AI-structured summary of a 10-K, 10-Q, or 8-K: overview, risk factors, MD&A, guidance\n- /api/v1/filing-search ($0.02): Full-text search across all SEC filings since 2001 by keyword, form type, and date\n- /api/v1/frames ($0.02): Compare one financial metric across every public company for a single period\n- /api/v1/form-3/{ticker} ($0.02): Initial insider ownership from SEC Form 3: holdings reported when an insider role begins\n- /api/v1/fund-holdings/{cik} ($0.03): Institutional 13F holdings for a fund by CIK: every position, value, and shares\n- /api/v1/fails-to-deliver/{ticker} ($0.02): Fails-to-deliver history for a stock: settlement-fail share volume by date\n- /api/v1/congress-trades ($0.03): US congressional stock trades (House & Senate) from STOCK Act disclosures: who traded what, when, and how much\n- /api/v1/treasury-yields ($0.01): US Treasury par yield curve (1mo to 30yr) for the latest day or a date range\n- /api/v1/inflation ($0.02): US CPI inflation: headline and core index with year-over-year percent\n- /api/v1/labor-market ($0.02): US labor market: unemployment, participation, payrolls, and wage growth\n- /api/v1/trending/reddit ($0.01): Trending tickers on Reddit (last 24h): the most-mentioned stocks, crypto, or both\n- /api/v1/trending/4chan ($0.01): Trending tickers on 4chan /biz/ (last 24h): the most-mentioned by post volume\n- /api/v1/market-status (free): Current US market status (open / closed / pre / post)\n- /api/v1/market-holidays (free): Upcoming US market holidays & early closes\n\nMachine-readable spec: /openapi.json. Payable resource catalog: /.well-known/x402 (also /.well-known/x402.json)."},"servers":[{"url":"https://x402stock.xyz"}],"tags":[{"name":"V1"}],"paths":{"/api/v1/overview/{ticker}":{"get":{"operationId":"v1_overview_{ticker}","summary":"Use when you need a full picture of one US-listed stock without making a dozen calls. Returns company profile, delayed price with OHLCV, fundamentals with computed P/E and margins, dividend yield, splits and corporate events, technical indicators (RSI, SMA, EMA, MACD) with neutral zone labels, recent news, and peers. A `sections` map flags anything unavailable. From x402stock","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"},"sections":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"profile":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"exchange":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"anyOf":[{"type":"string"},{"type":"null"}]},"sector":{"anyOf":[{"type":"string"},{"type":"null"}]},"sic_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"market_cap":{"anyOf":[{"type":"number"},{"type":"null"}]},"shares_outstanding":{"anyOf":[{"type":"number"},{"type":"null"}]},"employees":{"anyOf":[{"type":"number"},{"type":"null"}]},"list_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"homepage":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["name","sector","sic_code","market_cap","shares_outstanding","employees","list_date","homepage","description","logo_url"],"additionalProperties":false},{"type":"null"}]},"price":{"anyOf":[{"type":"object","properties":{"last":{"anyOf":[{"type":"number"},{"type":"null"}]},"change":{"anyOf":[{"type":"number"},{"type":"null"}]},"change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"day":{"anyOf":[{"type":"object","properties":{"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"vwap":{"type":"number"}},"required":["open","high","low","close","volume","vwap"],"additionalProperties":false},{"type":"null"}]},"previous_close":{"anyOf":[{"type":"number"},{"type":"null"}]},"is_delayed":{"type":"boolean"},"delayed_by":{"type":"string"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["last","change","change_percent","previous_close","is_delayed","delayed_by","timestamp"],"additionalProperties":false},{"type":"null"}]},"fundamentals":{"anyOf":[{"type":"object","properties":{"period":{"anyOf":[{"type":"string"},{"type":"null"}]},"fiscal_period":{"anyOf":[{"type":"string"},{"type":"null"}]},"fiscal_year":{"anyOf":[{"type":"string"},{"type":"null"}]},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"revenue":{"anyOf":[{"type":"number"},{"type":"null"}]},"net_income":{"anyOf":[{"type":"number"},{"type":"null"}]},"gross_profit":{"anyOf":[{"type":"number"},{"type":"null"}]},"eps":{"anyOf":[{"type":"number"},{"type":"null"}]},"pe_ratio":{"anyOf":[{"type":"number"},{"type":"null"}]},"gross_margin_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"net_margin_percent":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["period","fiscal_period","fiscal_year","end_date","revenue","net_income","gross_profit","eps","pe_ratio","gross_margin_percent","net_margin_percent"],"additionalProperties":false},{"type":"null"}]},"dividends":{"type":"object","properties":{"annualized_amount":{"anyOf":[{"type":"number"},{"type":"null"}]},"yield_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"frequency":{"anyOf":[{"type":"number"},{"type":"null"}]},"last":{"anyOf":[{"type":"object","properties":{"cash_amount":{"type":"number"},"ex_dividend_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"pay_date":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["cash_amount","ex_dividend_date","pay_date"],"additionalProperties":false},{"type":"null"}]},"count":{"type":"number"}},"required":["annualized_amount","yield_percent","frequency","last","count"],"additionalProperties":false},"corporate_actions":{"type":"object","properties":{"splits":{"type":"array","items":{"type":"object","properties":{"execution_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"split_from":{"type":"number"},"split_to":{"type":"number"},"ratio":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["execution_date","split_from","split_to","ratio"],"additionalProperties":false}},"events":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"date":{"type":"string"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","date","ticker"],"additionalProperties":false}}},"required":["splits","events"],"additionalProperties":false},"technicals":{"type":"object","properties":{"rsi_14":{"anyOf":[{"type":"object","properties":{"value":{"anyOf":[{"type":"number"},{"type":"null"}]},"zone":{"type":"string"}},"required":["value","zone"],"additionalProperties":false},{"type":"null"}]},"sma_50":{"anyOf":[{"type":"object","properties":{"value":{"anyOf":[{"type":"number"},{"type":"null"}]},"price_vs_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"position":{"type":"string"}},"required":["value","price_vs_percent","position"],"additionalProperties":false},{"type":"null"}]},"ema_20":{"anyOf":[{"type":"object","properties":{"value":{"anyOf":[{"type":"number"},{"type":"null"}]},"price_vs_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"position":{"type":"string"}},"required":["value","price_vs_percent","position"],"additionalProperties":false},{"type":"null"}]},"macd":{"anyOf":[{"type":"object","properties":{"value":{"anyOf":[{"type":"number"},{"type":"null"}]},"signal":{"anyOf":[{"type":"number"},{"type":"null"}]},"histogram":{"anyOf":[{"type":"number"},{"type":"null"}]},"position":{"type":"string"}},"required":["value","signal","histogram","position"],"additionalProperties":false},{"type":"null"}]}},"required":["rsi_14","sma_50","ema_20","macd"],"additionalProperties":false},"news":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"},"publisher":{"type":"string"},"published_at":{"type":"string"},"tickers":{"type":"array","items":{"type":"string"}}},"required":["title","url","publisher","published_at","tickers"],"additionalProperties":false}},"peers":{"type":"array","items":{"type":"string"}}},"required":["ticker","source","as_of","sections","profile","price","fundamentals","dividends","corporate_actions","technicals","news","peers"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/compare":{"get":{"operationId":"v1_compare","summary":"Use to compare 2 to 3 US-listed stocks in one call (peer or watchlist comparisons). For each ticker it returns price and day change, market cap, P/E, EPS, revenue, gross and net margins, and dividend yield, computed from snapshot, fundamentals, and profile data. Pass a comma separated list via `?tickers=AAPL,MSFT,NVDA`. From x402stock, a US stock market data API (x402, USDC).","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"tickers","schema":{"type":"string","minLength":1},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"},"count":{"type":"number"},"tickers":{"type":"array","items":{"type":"string"}},"rows":{"type":"array","items":{"type":"object","properties":{"ticker":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"market_cap":{"anyOf":[{"type":"number"},{"type":"null"}]},"pe_ratio":{"anyOf":[{"type":"number"},{"type":"null"}]},"eps":{"anyOf":[{"type":"number"},{"type":"null"}]},"revenue":{"anyOf":[{"type":"number"},{"type":"null"}]},"gross_margin_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"net_margin_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"dividend_yield_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"available":{"type":"string"}},"required":["ticker","name","price","change_percent","market_cap","pe_ratio","eps","revenue","gross_margin_percent","net_margin_percent","dividend_yield_percent","available"],"additionalProperties":false}}},"required":["source","as_of","count","tickers","rows"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/technicals/{ticker}":{"get":{"operationId":"v1_technicals_{ticker}","summary":"Use for a quick momentum or trend read on a US-listed stock. Returns the latest RSI (14) with overbought, oversold, or neutral zone, SMA 50 and EMA 20 with price position, and MACD with signal cross state, alongside the current delayed price. Factual indicator readings, not buy or sell guidance. From x402stock, a US stock market data API. Pay per request in USDC via x402, no API key.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"price":{"type":"object","properties":{"last":{"anyOf":[{"type":"number"},{"type":"null"}]},"change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["last","change_percent"],"additionalProperties":false},"rsi_14":{"anyOf":[{"type":"object","properties":{"value":{"anyOf":[{"type":"number"},{"type":"null"}]},"zone":{"type":"string"}},"required":["value","zone"],"additionalProperties":false},{"type":"null"}]},"sma_50":{"anyOf":[{"type":"object","properties":{"value":{"anyOf":[{"type":"number"},{"type":"null"}]},"price_vs_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"position":{"type":"string"}},"required":["value","price_vs_percent","position"],"additionalProperties":false},{"type":"null"}]},"ema_20":{"anyOf":[{"type":"object","properties":{"value":{"anyOf":[{"type":"number"},{"type":"null"}]},"price_vs_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"position":{"type":"string"}},"required":["value","price_vs_percent","position"],"additionalProperties":false},{"type":"null"}]},"macd":{"anyOf":[{"type":"object","properties":{"value":{"anyOf":[{"type":"number"},{"type":"null"}]},"signal":{"anyOf":[{"type":"number"},{"type":"null"}]},"histogram":{"anyOf":[{"type":"number"},{"type":"null"}]},"position":{"type":"string"}},"required":["value","signal","histogram","position"],"additionalProperties":false},{"type":"null"}]}},"required":["price","rsi_14","sma_50","ema_20","macd"],"additionalProperties":false},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/market-pulse":{"get":{"operationId":"v1_market-pulse","summary":"Use to find the day's biggest movers in one call. Returns the top 10 gainers and top 10 losers by percent move with price, the current US market session status (open, closed, pre, or post), and the latest market news headlines. No ticker needed. Built for agents scanning what is moving today. From x402stock, a US stock market data API. Pay per request in USDC via x402, no API key.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"limit","schema":{"type":"integer","exclusiveMinimum":0,"maximum":50}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"},"market_status":{"anyOf":[{"type":"object","properties":{"market":{"type":"string"},"early_hours":{"type":"boolean"},"after_hours":{"type":"boolean"}},"required":["market","early_hours","after_hours"],"additionalProperties":false},{"type":"null"}]},"gainers":{"type":"array","items":{"type":"object","properties":{"ticker":{"type":"string"},"change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["ticker","change_percent","price"],"additionalProperties":false}},"losers":{"type":"array","items":{"type":"object","properties":{"ticker":{"type":"string"},"change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["ticker","change_percent","price"],"additionalProperties":false}},"news":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"},"publisher":{"type":"string"},"published_at":{"type":"string"},"tickers":{"type":"array","items":{"type":"string"}}},"required":["title","url","publisher","published_at","tickers"],"additionalProperties":false}}},"required":["source","as_of","market_status","gainers","losers","news"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/quote/{ticker}":{"get":{"operationId":"v1_quote_{ticker}","summary":"Get the latest available price for any US-listed stock: the most recent 1-minute bar close plus today's OHLCV, change, and previous close. Currently 15 minutes delayed; each response carries `is_delayed: true`. Real-time pricing lands when the data plan is upgraded. From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"change":{"anyOf":[{"type":"number"},{"type":"null"}]},"change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"day":{"type":"object","properties":{"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"vwap":{"type":"number"}},"required":["open","high","low","close","volume"],"additionalProperties":false},"previous_close":{"anyOf":[{"type":"number"},{"type":"null"}]},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}]},"is_delayed":{"type":"boolean"},"delayed_by":{"type":"string"}},"required":["price","change","change_percent","previous_close","timestamp","is_delayed","delayed_by"],"additionalProperties":false},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/snapshot/{ticker}":{"get":{"operationId":"v1_snapshot_{ticker}","summary":"Single-call snapshot of a ticker's current state: last quote, last trade, today's OHLC + volume + VWAP, previous-day OHLC, today's change vs previous close. From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"change":{"anyOf":[{"type":"number"},{"type":"null"}]},"change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"day":{"type":"object","properties":{"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"vwap":{"type":"number"}},"required":["open","high","low","close","volume"],"additionalProperties":false},"previous_day":{"type":"object","properties":{"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"vwap":{"type":"number"}},"required":["open","high","low","close","volume"],"additionalProperties":false},"last_minute_bar":{"type":"object","properties":{"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"vwap":{"type":"number"},"trade_count":{"type":"number"},"accumulated_volume":{"type":"number"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["open","high","low","close","volume","vwap","timestamp"],"additionalProperties":false},"last_trade":{"type":"object","properties":{"price":{"type":"number"},"size":{"type":"number"},"exchange_id":{"type":"number"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}]},"conditions":{"type":"array","items":{"type":"number"}}},"required":["price","size","exchange_id","timestamp","conditions"],"additionalProperties":false},"last_quote":{"type":"object","properties":{"bid_price":{"type":"number"},"bid_size":{"type":"number"},"ask_price":{"type":"number"},"ask_size":{"type":"number"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["bid_price","bid_size","ask_price","ask_size","timestamp"],"additionalProperties":false}},"additionalProperties":false},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/ticker/{ticker}":{"get":{"operationId":"v1_ticker_{ticker}","summary":"Company name, exchange, market cap, share class, SIC code, address, and other reference fields for a US-listed ticker. From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"name":{"type":"string"},"market":{"type":"string"},"locale":{"type":"string"},"type":{"anyOf":[{"type":"string"},{"type":"null"}]},"primary_exchange":{"anyOf":[{"type":"string"},{"type":"null"}]},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"active":{"type":"boolean"},"cik":{"anyOf":[{"type":"string"},{"type":"null"}]},"composite_figi":{"anyOf":[{"type":"string"},{"type":"null"}]},"share_class_figi":{"anyOf":[{"type":"string"},{"type":"null"}]},"market_cap":{"anyOf":[{"type":"number"},{"type":"null"}]},"sic_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"sic_description":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"homepage":{"anyOf":[{"type":"string"},{"type":"null"}]},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]},"address":{"anyOf":[{"type":"object","properties":{"address1":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"postal_code":{"type":"string"}},"additionalProperties":false},{"type":"null"}]},"list_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"employees":{"anyOf":[{"type":"number"},{"type":"null"}]},"shares_outstanding":{"anyOf":[{"type":"number"},{"type":"null"}]},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"icon_url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["name","market","locale","active","cik","composite_figi","share_class_figi","market_cap","sic_code","sic_description","description","homepage","phone","address","list_date","employees","shares_outstanding","logo_url","icon_url"],"additionalProperties":false},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/aggregates/{ticker}":{"get":{"operationId":"v1_aggregates_{ticker}","summary":"The stock price history endpoint. Returns historical OHLCV bars at the requested multiplier and timespan (minute, hour, day, week, month) between `from` and `to`. Use for price history, charting, backtesting, and trend analysis over any date range. From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"multiplier","schema":{"default":1,"type":"integer","exclusiveMinimum":0,"maximum":50000}},{"in":"query","name":"timespan","schema":{"default":"day","type":"string","enum":["minute","hour","day","week","month","quarter","year"]}},{"in":"query","name":"from","schema":{"default":"2025-06-03","type":"string","minLength":1}},{"in":"query","name":"to","schema":{"default":"2026-06-03","type":"string","minLength":1}},{"in":"query","name":"adjusted","schema":{"default":true,"type":"boolean"}},{"in":"query","name":"sort","schema":{"default":"asc","type":"string","enum":["asc","desc"]}},{"in":"query","name":"limit","schema":{"default":5000,"type":"integer","exclusiveMinimum":0,"maximum":50000}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"bars":{"type":"array","items":{"type":"object","properties":{"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"vwap":{"anyOf":[{"type":"number"},{"type":"null"}]},"trade_count":{"anyOf":[{"type":"number"},{"type":"null"}]},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["open","high","low","close","volume","vwap","trade_count","timestamp"],"additionalProperties":false}},"count":{"type":"number"},"adjusted":{"type":"boolean"}},"required":["bars","count"],"additionalProperties":false},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/news":{"get":{"operationId":"v1_news","summary":"Curated stock-market news with ticker tags, source, publisher, image, and timestamps. Pass `?ticker=AAPL` to filter. From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"ticker","schema":{"type":"string","pattern":"^[A-Z][A-Z0-9.\\-]{0,9}$"}},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","exclusiveMinimum":0,"maximum":50}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"},"count":{"type":"number"},"articles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"type":"string"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"author":{"anyOf":[{"type":"string"},{"type":"null"}]},"publisher":{"type":"string"},"publisher_homepage":{"type":"string"},"published_at":{"type":"string"},"tickers":{"type":"array","items":{"type":"string"}},"keywords":{"type":"array","items":{"type":"string"}}},"required":["id","title","description","url","image_url","author","publisher","publisher_homepage","published_at","tickers","keywords"],"additionalProperties":false}}},"required":["source","as_of","count","articles"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/market-status":{"get":{"operationId":"v1_market-status","summary":"v1/market-status","tags":["V1"],"security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"},"market":{"type":"string"},"early_hours":{"type":"boolean"},"after_hours":{"type":"boolean"},"exchanges":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"currencies":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}}},"required":["source","as_of","market","early_hours","after_hours","exchanges","currencies"],"additionalProperties":false}}}}}}},"/api/v1/prev-close/{ticker}":{"get":{"operationId":"v1_prev-close_{ticker}","summary":"Open, high, low, close, volume, and VWAP for a ticker's most recent completed trading day. One call returns one bar, handy for prior-close reference without setting a date range. From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"anyOf":[{"type":"object","properties":{"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"vwap":{"anyOf":[{"type":"number"},{"type":"null"}]},"trade_count":{"anyOf":[{"type":"number"},{"type":"null"}]},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["open","high","low","close","volume","vwap","trade_count","timestamp"],"additionalProperties":false},{"type":"null"}]},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/open-close/{ticker}":{"get":{"operationId":"v1_open-close_{ticker}","summary":"Official open, close, high, low, volume, plus pre-market and after-hours prices for a ticker on a given date. Pass `?date=YYYY-MM-DD` (required). From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"date","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"required":true},{"in":"query","name":"adjusted","schema":{"default":true,"type":"boolean"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"date":{"type":"string"},"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"pre_market":{"anyOf":[{"type":"number"},{"type":"null"}]},"after_hours":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["date","open","high","low","close","volume","pre_market","after_hours"],"additionalProperties":false},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/dividends/{ticker}":{"get":{"operationId":"v1_dividends_{ticker}","summary":"Historical cash dividends for a ticker: amount, currency, type, frequency, and the declaration / ex-dividend / record / pay dates. Most recent first. From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"limit","schema":{"default":10,"type":"integer","exclusiveMinimum":0,"maximum":1000}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"count":{"type":"number"},"dividends":{"type":"array","items":{"type":"object","properties":{"cash_amount":{"type":"number"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"dividend_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"frequency":{"anyOf":[{"type":"number"},{"type":"null"}]},"declaration_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"ex_dividend_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"record_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"pay_date":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["cash_amount","currency","dividend_type","frequency","declaration_date","ex_dividend_date","record_date","pay_date"],"additionalProperties":false}}},"required":["count","dividends"],"additionalProperties":false},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/splits/{ticker}":{"get":{"operationId":"v1_splits_{ticker}","summary":"Historical stock splits for a ticker, with execution date and split ratio (split_from to split_to). Most recent first. From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"limit","schema":{"default":10,"type":"integer","exclusiveMinimum":0,"maximum":1000}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"count":{"type":"number"},"splits":{"type":"array","items":{"type":"object","properties":{"execution_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"split_from":{"type":"number"},"split_to":{"type":"number"},"ratio":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["execution_date","split_from","split_to","ratio"],"additionalProperties":false}}},"required":["count","splits"],"additionalProperties":false},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/financials/{ticker}":{"get":{"operationId":"v1_financials_{ticker}","summary":"Per-period financial statements (income statement, balance sheet, cash flow, comprehensive income) sourced from SEC filings, flattened to fact_key → value maps. Pass `?timeframe=annual|quarterly|ttm` and `?limit=`. From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"timeframe","schema":{"type":"string","enum":["annual","quarterly","ttm"]}},{"in":"query","name":"limit","schema":{"default":4,"type":"integer","exclusiveMinimum":0,"maximum":100}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"count":{"type":"number"},"reports":{"type":"array","items":{"type":"object","properties":{"company_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"cik":{"anyOf":[{"type":"string"},{"type":"null"}]},"timeframe":{"anyOf":[{"type":"string"},{"type":"null"}]},"fiscal_period":{"anyOf":[{"type":"string"},{"type":"null"}]},"fiscal_year":{"anyOf":[{"type":"string"},{"type":"null"}]},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"filing_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_filing_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"statements":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"number"},{"type":"null"}]}}}},"required":["company_name","cik","timeframe","fiscal_period","fiscal_year","start_date","end_date","filing_date","source_filing_url","statements"],"additionalProperties":false}}},"required":["count","reports"],"additionalProperties":false},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/events/{ticker}":{"get":{"operationId":"v1_events_{ticker}","summary":"Timeline of corporate events for a ticker, such as ticker symbol changes, with the company name, CIK, and composite FIGI. From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"composite_figi":{"anyOf":[{"type":"string"},{"type":"null"}]},"cik":{"anyOf":[{"type":"string"},{"type":"null"}]},"events":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"date":{"type":"string"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","date","ticker"],"additionalProperties":false}}},"required":["name","composite_figi","cik","events"],"additionalProperties":false},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/related/{ticker}":{"get":{"operationId":"v1_related_{ticker}","summary":"Tickers related to the given symbol based on news and analyst coverage co-occurrence, a quick peer set for comparative analysis. From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"count":{"type":"number"},"related":{"type":"array","items":{"type":"string"}}},"required":["count","related"],"additionalProperties":false},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/indicators/sma/{ticker}":{"get":{"operationId":"v1_indicators_sma_{ticker}","summary":"Simple Moving Average time series. Tune with `?window=`, `?timespan=`, `?series_type=`, `?limit=`. From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"timespan","schema":{"default":"day","type":"string","enum":["minute","hour","day","week","month","quarter","year"]}},{"in":"query","name":"window","schema":{"default":50,"type":"integer","exclusiveMinimum":0,"maximum":2000}},{"in":"query","name":"series_type","schema":{"default":"close","type":"string","enum":["open","high","low","close"]}},{"in":"query","name":"adjusted","schema":{"default":true,"type":"boolean"}},{"in":"query","name":"limit","schema":{"default":30,"type":"integer","exclusiveMinimum":0,"maximum":5000}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"indicator":{"type":"string"},"count":{"type":"number"},"values":{"type":"array","items":{"type":"object","properties":{"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}]},"value":{"type":"number"},"signal":{"type":"number"},"histogram":{"type":"number"}},"required":["timestamp","value"],"additionalProperties":false}}},"required":["indicator","count","values"],"additionalProperties":false},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/indicators/ema/{ticker}":{"get":{"operationId":"v1_indicators_ema_{ticker}","summary":"Exponential Moving Average time series. Tune with `?window=`, `?timespan=`, `?series_type=`, `?limit=`. From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"timespan","schema":{"default":"day","type":"string","enum":["minute","hour","day","week","month","quarter","year"]}},{"in":"query","name":"window","schema":{"default":50,"type":"integer","exclusiveMinimum":0,"maximum":2000}},{"in":"query","name":"series_type","schema":{"default":"close","type":"string","enum":["open","high","low","close"]}},{"in":"query","name":"adjusted","schema":{"default":true,"type":"boolean"}},{"in":"query","name":"limit","schema":{"default":30,"type":"integer","exclusiveMinimum":0,"maximum":5000}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"indicator":{"type":"string"},"count":{"type":"number"},"values":{"type":"array","items":{"type":"object","properties":{"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}]},"value":{"type":"number"},"signal":{"type":"number"},"histogram":{"type":"number"}},"required":["timestamp","value"],"additionalProperties":false}}},"required":["indicator","count","values"],"additionalProperties":false},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/indicators/rsi/{ticker}":{"get":{"operationId":"v1_indicators_rsi_{ticker}","summary":"Relative Strength Index time series (momentum oscillator). Tune with `?window=` (default 14), `?timespan=`, `?series_type=`, `?limit=`. From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"timespan","schema":{"default":"day","type":"string","enum":["minute","hour","day","week","month","quarter","year"]}},{"in":"query","name":"window","schema":{"default":14,"type":"integer","exclusiveMinimum":0,"maximum":2000}},{"in":"query","name":"series_type","schema":{"default":"close","type":"string","enum":["open","high","low","close"]}},{"in":"query","name":"adjusted","schema":{"default":true,"type":"boolean"}},{"in":"query","name":"limit","schema":{"default":30,"type":"integer","exclusiveMinimum":0,"maximum":5000}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"indicator":{"type":"string"},"count":{"type":"number"},"values":{"type":"array","items":{"type":"object","properties":{"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}]},"value":{"type":"number"},"signal":{"type":"number"},"histogram":{"type":"number"}},"required":["timestamp","value"],"additionalProperties":false}}},"required":["indicator","count","values"],"additionalProperties":false},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/indicators/macd/{ticker}":{"get":{"operationId":"v1_indicators_macd_{ticker}","summary":"MACD time series with value, signal line, and histogram. Tune with `?short_window=`, `?long_window=`, `?signal_window=`, `?timespan=`, `?series_type=`, `?limit=`. From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"timespan","schema":{"default":"day","type":"string","enum":["minute","hour","day","week","month","quarter","year"]}},{"in":"query","name":"series_type","schema":{"default":"close","type":"string","enum":["open","high","low","close"]}},{"in":"query","name":"adjusted","schema":{"default":true,"type":"boolean"}},{"in":"query","name":"short_window","schema":{"default":12,"type":"integer","exclusiveMinimum":0,"maximum":2000}},{"in":"query","name":"long_window","schema":{"default":26,"type":"integer","exclusiveMinimum":0,"maximum":2000}},{"in":"query","name":"signal_window","schema":{"default":9,"type":"integer","exclusiveMinimum":0,"maximum":2000}},{"in":"query","name":"limit","schema":{"default":30,"type":"integer","exclusiveMinimum":0,"maximum":5000}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"indicator":{"type":"string"},"count":{"type":"number"},"values":{"type":"array","items":{"type":"object","properties":{"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}]},"value":{"type":"number"},"signal":{"type":"number"},"histogram":{"type":"number"}},"required":["timestamp","value"],"additionalProperties":false}}},"required":["indicator","count","values"],"additionalProperties":false},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/gainers":{"get":{"operationId":"v1_gainers","summary":"The day's biggest percentage gainers across US equities, with current and previous-day OHLCV per ticker. From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"limit","schema":{"type":"integer","exclusiveMinimum":0,"maximum":100}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"},"direction":{"type":"string","enum":["gainers","losers"]},"count":{"type":"number"},"tickers":{"type":"array","items":{"type":"object","properties":{"ticker":{"type":"string"},"change":{"type":"number"},"change_percent":{"type":"number"},"updated":{"anyOf":[{"type":"string"},{"type":"null"}]},"day":{"type":"object","properties":{"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"vwap":{"type":"number"}},"required":["open","high","low","close","volume","vwap"],"additionalProperties":false},"previous_day":{"type":"object","properties":{"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"vwap":{"type":"number"}},"required":["open","high","low","close","volume","vwap"],"additionalProperties":false}},"required":["ticker","change","change_percent","updated"],"additionalProperties":false}}},"required":["source","as_of","direction","count","tickers"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/losers":{"get":{"operationId":"v1_losers","summary":"The day's biggest percentage losers across US equities, with current and previous-day OHLCV per ticker. From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"limit","schema":{"type":"integer","exclusiveMinimum":0,"maximum":100}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"},"direction":{"type":"string","enum":["gainers","losers"]},"count":{"type":"number"},"tickers":{"type":"array","items":{"type":"object","properties":{"ticker":{"type":"string"},"change":{"type":"number"},"change_percent":{"type":"number"},"updated":{"anyOf":[{"type":"string"},{"type":"null"}]},"day":{"type":"object","properties":{"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"vwap":{"type":"number"}},"required":["open","high","low","close","volume","vwap"],"additionalProperties":false},"previous_day":{"type":"object","properties":{"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"vwap":{"type":"number"}},"required":["open","high","low","close","volume","vwap"],"additionalProperties":false}},"required":["ticker","change","change_percent","updated"],"additionalProperties":false}}},"required":["source","as_of","direction","count","tickers"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/grouped-daily":{"get":{"operationId":"v1_grouped-daily","summary":"End-of-day OHLCV bars for every US-listed ticker on a single date; one call returns the entire market. Pass `?date=YYYY-MM-DD` (required). From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"date","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"required":true},{"in":"query","name":"adjusted","schema":{"default":true,"type":"boolean"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"},"date":{"type":"string"},"adjusted":{"type":"boolean"},"count":{"type":"number"},"results":{"type":"array","items":{"type":"object","properties":{"ticker":{"type":"string"},"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"vwap":{"anyOf":[{"type":"number"},{"type":"null"}]},"trade_count":{"anyOf":[{"type":"number"},{"type":"null"}]},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["ticker","open","high","low","close","volume","vwap","trade_count","timestamp"],"additionalProperties":false}}},"required":["source","as_of","date","count","results"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/full-market-snapshot":{"get":{"operationId":"v1_full-market-snapshot","summary":"Current state of every US-listed ticker in a single call: price, day change and percent change, volume, and VWAP per symbol. The base layer for building a screener or scanning the whole market without iterating ticker by ticker. Optional `?tickers=AAPL,MSFT` to narrow and `?include_otc=true` to add OTC names. From x402stock, a US stock market data API (x402, USDC).","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"tickers","schema":{"type":"string","minLength":1}},{"in":"query","name":"include_otc","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"},"count":{"type":"number"},"tickers":{"type":"array","items":{"type":"object","properties":{"ticker":{"type":"string"},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"change":{"anyOf":[{"type":"number"},{"type":"null"}]},"change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"volume":{"anyOf":[{"type":"number"},{"type":"null"}]},"vwap":{"anyOf":[{"type":"number"},{"type":"null"}]},"updated":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["ticker","price","change","change_percent","volume","vwap","updated"],"additionalProperties":false}}},"required":["source","as_of","count","tickers"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/unified-snapshot":{"get":{"operationId":"v1_unified-snapshot","summary":"Snapshot a list of US-listed tickers at once: for each symbol, the company name, market session, current price, day change and percent change, day OHLCV with VWAP, and previous close. Pass a comma-separated list via `?tickers=AAPL,MSFT,NVDA` (up to 250). Built for pricing a watchlist or portfolio in a single request. From x402stock, a US stock market data API (x402, USDC).","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"tickers","schema":{"type":"string","minLength":1},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"},"count":{"type":"number"},"tickers":{"type":"array","items":{"type":"object","properties":{"ticker":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"market_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"change":{"anyOf":[{"type":"number"},{"type":"null"}]},"change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"day":{"anyOf":[{"type":"object","properties":{"open":{"anyOf":[{"type":"number"},{"type":"null"}]},"high":{"anyOf":[{"type":"number"},{"type":"null"}]},"low":{"anyOf":[{"type":"number"},{"type":"null"}]},"close":{"anyOf":[{"type":"number"},{"type":"null"}]},"volume":{"anyOf":[{"type":"number"},{"type":"null"}]},"vwap":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["open","high","low","close","volume","vwap"],"additionalProperties":false},{"type":"null"}]},"previous_close":{"anyOf":[{"type":"number"},{"type":"null"}]},"updated":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["ticker","name","market_status","price","change","change_percent","day","previous_close","updated"],"additionalProperties":false}}},"required":["source","as_of","count","tickers"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/options/{ticker}":{"get":{"operationId":"v1_options_{ticker}","summary":"The options chain for a US-listed underlying: every listed contract with its strike price, expiration date, call or put type, exercise style, contract ticker, and shares per contract. Filter with ?expiration_date=YYYY-MM-DD, ?contract_type=call|put, ?strike_price=, ?expired=true|false, and ?limit=. Use to discover which option contracts exist before pulling price history. From x402stock","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"contract_type","schema":{"type":"string","enum":["call","put"]}},{"in":"query","name":"expiration_date","schema":{"type":"string"}},{"in":"query","name":"strike_price","schema":{"type":"number","exclusiveMinimum":0}},{"in":"query","name":"expired","schema":{"type":"boolean"}},{"in":"query","name":"limit","schema":{"default":50,"type":"integer","exclusiveMinimum":0,"maximum":1000}},{"in":"query","name":"order","schema":{"default":"asc","type":"string","enum":["asc","desc"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"count":{"type":"number"},"contracts":{"type":"array","items":{"type":"object","properties":{"contract_ticker":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"anyOf":[{"type":"string"},{"type":"null"}]},"strike":{"anyOf":[{"type":"number"},{"type":"null"}]},"expiration_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"exercise_style":{"anyOf":[{"type":"string"},{"type":"null"}]},"shares_per_contract":{"anyOf":[{"type":"number"},{"type":"null"}]},"primary_exchange":{"anyOf":[{"type":"string"},{"type":"null"}]},"cfi":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["contract_ticker","type","strike","expiration_date","exercise_style","shares_per_contract","primary_exchange","cfi"],"additionalProperties":false}}},"required":["count","contracts"],"additionalProperties":false},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/options-aggregates/{contract}":{"get":{"operationId":"v1_options-aggregates_{contract}","summary":"Historical OHLCV price bars for one option contract over any date range. Pass the option contract ticker in the path (e.g. O:AAPL260620C00150000) and tune ?multiplier=, ?timespan=minute|hour|day|week|month, ?from= and ?to= (optional; default to the trailing year), ?adjusted=, ?sort=, and ?limit=. Use for backtesting or charting a single option's price history. From x402stock","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"multiplier","schema":{"default":1,"type":"integer","exclusiveMinimum":0,"maximum":50000}},{"in":"query","name":"timespan","schema":{"default":"day","type":"string","enum":["minute","hour","day","week","month","quarter","year"]}},{"in":"query","name":"from","schema":{"default":"2025-06-03","type":"string","minLength":1}},{"in":"query","name":"to","schema":{"default":"2026-06-03","type":"string","minLength":1}},{"in":"query","name":"adjusted","schema":{"default":true,"type":"boolean"}},{"in":"query","name":"sort","schema":{"default":"asc","type":"string","enum":["asc","desc"]}},{"in":"query","name":"limit","schema":{"default":5000,"type":"integer","exclusiveMinimum":0,"maximum":50000}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"bars":{"type":"array","items":{"type":"object","properties":{"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"vwap":{"anyOf":[{"type":"number"},{"type":"null"}]},"trade_count":{"anyOf":[{"type":"number"},{"type":"null"}]},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["open","high","low","close","volume","vwap","trade_count","timestamp"],"additionalProperties":false}},"count":{"type":"number"},"adjusted":{"type":"boolean"}},"required":["bars","count"],"additionalProperties":false},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/short-interest/{ticker}":{"get":{"operationId":"v1_short-interest_{ticker}","summary":"The exchange-reported short-interest history for a US-listed stock: total shares sold short, average daily volume, and days-to-cover for each bi-weekly FINRA settlement date, most recent first. A core short-squeeze and bearish-positioning signal. Tune how many settlements to return with `?limit=` (default 12). From x402stock, a US stock market data API (x402, USDC).","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"limit","schema":{"type":"integer","exclusiveMinimum":0,"maximum":100}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"count":{"type":"number"},"latest":{"anyOf":[{"type":"object","properties":{"settlement_date":{"type":"string"},"short_interest":{"type":"number"},"avg_daily_volume":{"type":"number"},"days_to_cover":{"type":"number"}},"required":["settlement_date","short_interest","avg_daily_volume","days_to_cover"],"additionalProperties":false},{"type":"null"}]},"history":{"type":"array","items":{"type":"object","properties":{"settlement_date":{"type":"string"},"short_interest":{"type":"number"},"avg_daily_volume":{"type":"number"},"days_to_cover":{"type":"number"}},"required":["settlement_date","short_interest","avg_daily_volume","days_to_cover"],"additionalProperties":false}}},"required":["count","latest","history"],"additionalProperties":false},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/short-volume/{ticker}":{"get":{"operationId":"v1_short-volume_{ticker}","summary":"Daily short-sale volume for a US-listed stock: total volume, short volume, exempt and non-exempt short volume, the short-volume ratio, and a per-venue breakdown (NYSE, Nasdaq, ADF), most recent day first. A higher-frequency read on shorting pressure than bi-weekly short interest. Tune with `?limit=` (default 20). From x402stock, a US stock market data API (x402, USDC).","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"limit","schema":{"type":"integer","exclusiveMinimum":0,"maximum":100}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"count":{"type":"number"},"latest":{"anyOf":[{"type":"object","properties":{"date":{"type":"string"},"total_volume":{"type":"number"},"short_volume":{"type":"number"},"exempt_volume":{"type":"number"},"non_exempt_volume":{"type":"number"},"short_volume_ratio":{"type":"number"},"venues":{"type":"object","properties":{"nyse":{"anyOf":[{"type":"number"},{"type":"null"}]},"nasdaq_carteret":{"anyOf":[{"type":"number"},{"type":"null"}]},"nasdaq_chicago":{"anyOf":[{"type":"number"},{"type":"null"}]},"adf":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["nyse","nasdaq_carteret","nasdaq_chicago","adf"],"additionalProperties":false}},"required":["date","total_volume","short_volume","exempt_volume","non_exempt_volume","short_volume_ratio","venues"],"additionalProperties":false},{"type":"null"}]},"history":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"total_volume":{"type":"number"},"short_volume":{"type":"number"},"exempt_volume":{"type":"number"},"non_exempt_volume":{"type":"number"},"short_volume_ratio":{"type":"number"},"venues":{"type":"object","properties":{"nyse":{"anyOf":[{"type":"number"},{"type":"null"}]},"nasdaq_carteret":{"anyOf":[{"type":"number"},{"type":"null"}]},"nasdaq_chicago":{"anyOf":[{"type":"number"},{"type":"null"}]},"adf":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["nyse","nasdaq_carteret","nasdaq_chicago","adf"],"additionalProperties":false}},"required":["date","total_volume","short_volume","exempt_volume","non_exempt_volume","short_volume_ratio","venues"],"additionalProperties":false}}},"required":["count","latest","history"],"additionalProperties":false},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/ipos":{"get":{"operationId":"v1_ipos","summary":"Upcoming and historical US IPOs: issuer name, ticker, announced and listing dates, offer price range and final price, shares offered, total deal size, exchange, and status. Filter by `?ipo_status=pending|new|history|rumor`, `?ticker=`, and `?limit=`. Use to track the new-issue calendar and recently priced deals. From x402stock, a US stock market data API (x402, USDC).","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"ticker","schema":{"type":"string","minLength":1,"maxLength":10}},{"in":"query","name":"ipo_status","schema":{"type":"string","enum":["pending","new","history","rumor","postponed","withdrawn"]}},{"in":"query","name":"limit","schema":{"default":20,"type":"integer","exclusiveMinimum":0,"maximum":250}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"},"count":{"type":"number"},"ipos":{"type":"array","items":{"type":"object","properties":{"ticker":{"anyOf":[{"type":"string"},{"type":"null"}]},"issuer_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"announced_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"listing_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"primary_exchange":{"anyOf":[{"type":"string"},{"type":"null"}]},"security_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"security_description":{"anyOf":[{"type":"string"},{"type":"null"}]},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"isin":{"anyOf":[{"type":"string"},{"type":"null"}]},"final_issue_price":{"anyOf":[{"type":"number"},{"type":"null"}]},"lowest_offer_price":{"anyOf":[{"type":"number"},{"type":"null"}]},"highest_offer_price":{"anyOf":[{"type":"number"},{"type":"null"}]},"max_shares_offered":{"anyOf":[{"type":"number"},{"type":"null"}]},"total_offer_size":{"anyOf":[{"type":"number"},{"type":"null"}]},"shares_outstanding":{"anyOf":[{"type":"number"},{"type":"null"}]},"last_updated":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["ticker","issuer_name","status","announced_date","listing_date","primary_exchange","security_type","security_description","currency","isin","final_issue_price","lowest_offer_price","highest_offer_price","max_shares_offered","total_offer_size","shares_outstanding","last_updated"],"additionalProperties":false}}},"required":["source","as_of","count","ipos"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/market-holidays":{"get":{"operationId":"v1_market-holidays","summary":"v1/market-holidays","tags":["V1"],"security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"},"count":{"type":"number"},"holidays":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"exchange":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"},"open":{"anyOf":[{"type":"string"},{"type":"null"}]},"close":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["date","exchange","name","status","open","close"],"additionalProperties":false}}},"required":["source","as_of","count","holidays"],"additionalProperties":false}}}}}}},"/api/v1/exchanges":{"get":{"operationId":"v1_exchanges","summary":"Reference list of US equity exchanges and market centers with names, MICs, operating MICs, and SIP participant IDs. From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"},"count":{"type":"number"},"exchanges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"type":{"type":"string"},"name":{"type":"string"},"acronym":{"anyOf":[{"type":"string"},{"type":"null"}]},"mic":{"anyOf":[{"type":"string"},{"type":"null"}]},"operating_mic":{"anyOf":[{"type":"string"},{"type":"null"}]},"participant_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","type","name","acronym","mic","operating_mic","participant_id","url"],"additionalProperties":false}}},"required":["source","as_of","count","exchanges"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/conditions":{"get":{"operationId":"v1_conditions","summary":"Reference catalog of trade/quote condition codes (the numeric `conditions` seen on trades) with names, types, data types, and SIP mappings. From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"limit","schema":{"default":50,"type":"integer","exclusiveMinimum":0,"maximum":1000}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"},"count":{"type":"number"},"conditions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"type":{"type":"string"},"name":{"type":"string"},"data_types":{"type":"array","items":{"type":"string"}},"sip_mapping":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}}},"required":["id","type","name","data_types","sip_mapping"],"additionalProperties":false}}},"required":["source","as_of","count","conditions"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/ticker-types":{"get":{"operationId":"v1_ticker-types","summary":"Reference list of security type codes used in ticker reference data (e.g. CS = Common Stock, ETF, PFD, WARRANT) with descriptions. From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"},"count":{"type":"number"},"types":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"description":{"type":"string"},"asset_class":{"type":"string"},"locale":{"type":"string"}},"required":["code","description","asset_class","locale"],"additionalProperties":false}}},"required":["source","as_of","count","types"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/tickers":{"get":{"operationId":"v1_tickers","summary":"Find tickers by free-text `?search=` (name or symbol) across asset classes via `?market=stocks|crypto|fx|indices` (default stocks), with optional `?type=`, `?exchange=`, `?active=`, `?limit=`. Returns symbol, name, market, exchange, type, and identifiers. Use to discover crypto pairs (X:BTCUSD), FX pairs (C:EURUSD), and index symbols (I:SPX). From x402stock","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"search","schema":{"type":"string","minLength":1,"maxLength":100}},{"in":"query","name":"type","schema":{"type":"string","minLength":1,"maxLength":20}},{"in":"query","name":"exchange","schema":{"type":"string","minLength":1,"maxLength":20}},{"in":"query","name":"market","schema":{"default":"stocks","type":"string","enum":["stocks","crypto","fx","indices"]}},{"in":"query","name":"active","schema":{"default":true,"type":"boolean"}},{"in":"query","name":"limit","schema":{"default":20,"type":"integer","exclusiveMinimum":0,"maximum":1000}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"},"count":{"type":"number"},"tickers":{"type":"array","items":{"type":"object","properties":{"ticker":{"type":"string"},"name":{"type":"string"},"market":{"type":"string"},"locale":{"type":"string"},"primary_exchange":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"anyOf":[{"type":"string"},{"type":"null"}]},"active":{"type":"boolean"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"cik":{"anyOf":[{"type":"string"},{"type":"null"}]},"composite_figi":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["ticker","name","market","locale","primary_exchange","type","active","currency","cik","composite_figi"],"additionalProperties":false}}},"required":["source","as_of","count","tickers"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/filings/{ticker}":{"get":{"operationId":"v1_filings_{ticker}","summary":"List a company's recent SEC EDGAR filings sourced directly from the SEC: form type, filing and report dates, the 8-K item codes, and a direct link to each primary document. Filter to a single form with `?type=10-K` (also 10-Q, 8-K, 4, etc.) and cap with `?limit=`. Use as the index into a company's disclosures before fetching or summarizing a specific filing. From x402stock","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"type","schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"default":20,"type":"integer","exclusiveMinimum":0,"maximum":100}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"cik":{"type":"string"},"company":{"type":"string"},"count":{"type":"number"},"filings":{"type":"array","items":{"type":"object","properties":{"form":{"type":"string"},"accession":{"type":"string"},"filing_date":{"type":"string"},"report_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"items":{"type":"array","items":{"type":"string"}},"primary_document":{"type":"string"},"url":{"type":"string"}},"required":["form","accession","filing_date","report_date","description","items","primary_document","url"],"additionalProperties":false}}},"required":["cik","company","count","filings"],"additionalProperties":false},"source":{"type":"string","const":"sec_edgar"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/insider-trades/{ticker}":{"get":{"operationId":"v1_insider-trades_{ticker}","summary":"Recent insider transactions parsed from SEC Form 4 filings: the reporting owner and their role (director, officer, 10% holder), each buy/sell with transaction code, share count, price, and shares held afterward, plus an aggregate net-buying/net-selling signal. Tune how many filings to parse with `?limit=` (default 5, max 25). Sourced live from SEC EDGAR. From x402stock","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"limit","schema":{"default":5,"type":"integer","exclusiveMinimum":0,"maximum":25}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"filings_parsed":{"type":"number"},"transaction_count":{"type":"number"},"summary":{"type":"object","properties":{"buys":{"type":"number"},"sells":{"type":"number"},"shares_bought":{"type":"number"},"shares_sold":{"type":"number"},"net_shares":{"type":"number"},"signal":{"type":"string","enum":["net_buying","net_selling","neutral"]}},"required":["buys","sells","shares_bought","shares_sold","net_shares","signal"],"additionalProperties":false},"transactions":{"type":"array","items":{"type":"object","properties":{"owner_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"is_director":{"type":"boolean"},"is_officer":{"type":"boolean"},"officer_title":{"anyOf":[{"type":"string"},{"type":"null"}]},"is_ten_percent_owner":{"type":"boolean"},"filing_date":{"type":"string"},"accession":{"type":"string"},"url":{"type":"string"},"security":{"anyOf":[{"type":"string"},{"type":"null"}]},"transaction_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"code":{"anyOf":[{"type":"string"},{"type":"null"}]},"code_label":{"anyOf":[{"type":"string"},{"type":"null"}]},"shares":{"anyOf":[{"type":"number"},{"type":"null"}]},"price_per_share":{"anyOf":[{"type":"number"},{"type":"null"}]},"acquired_disposed":{"anyOf":[{"type":"string","enum":["A","D"]},{"type":"null"}]},"shares_owned_after":{"anyOf":[{"type":"number"},{"type":"null"}]},"is_derivative":{"type":"boolean"}},"required":["owner_name","is_director","is_officer","officer_title","is_ten_percent_owner","filing_date","accession","url","security","transaction_date","code","code_label","shares","price_per_share","acquired_disposed","shares_owned_after","is_derivative"],"additionalProperties":false}}},"required":["filings_parsed","transaction_count","summary","transactions"],"additionalProperties":false},"source":{"type":"string","const":"sec_edgar"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/material-events/{ticker}":{"get":{"operationId":"v1_material-events_{ticker}","summary":"Recent 8-K material-event filings for a company, each classified by its SEC item code into a human-readable label (e.g. 2.02 Results of Operations, 5.02 Executive Changes, 1.01 Material Agreement). Returns filing date, item labels, and a link to the filing. Cap with `?limit=`. Use to track earnings releases, leadership changes, and material agreements. Sourced from SEC EDGAR. From x402stock","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"limit","schema":{"default":20,"type":"integer","exclusiveMinimum":0,"maximum":100}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"count":{"type":"number"},"events":{"type":"array","items":{"type":"object","properties":{"form":{"type":"string"},"accession":{"type":"string"},"filing_date":{"type":"string"},"report_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"label":{"type":"string"}},"required":["code","label"],"additionalProperties":false}}},"required":["form","accession","filing_date","report_date","url","items"],"additionalProperties":false}}},"required":["count","events"],"additionalProperties":false},"source":{"type":"string","const":"sec_edgar"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/concept/{ticker}":{"get":{"operationId":"v1_concept_{ticker}","summary":"The reported time series of one XBRL financial concept (e.g. Revenues, Assets, NetIncomeLoss) for a company, taken directly from its SEC filings. Pass the tag via `?tag=` and optionally `?taxonomy=` (default us-gaap) and `?limit=`. Each point carries the value, period, fiscal year/quarter, source form, and accession. Use for precise, filing-grade fundamentals and quant time series. From x402stock","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"tag","schema":{"type":"string"}},{"in":"query","name":"taxonomy","schema":{"default":"us-gaap","type":"string"}},{"in":"query","name":"limit","schema":{"default":8,"type":"integer","exclusiveMinimum":0,"maximum":100}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"tag":{"type":"string"},"taxonomy":{"type":"string"},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"unit":{"anyOf":[{"type":"string"},{"type":"null"}]},"count":{"type":"number"},"series":{"type":"array","items":{"type":"object","properties":{"value":{"type":"number"},"start":{"anyOf":[{"type":"string"},{"type":"null"}]},"end":{"type":"string"},"fiscal_year":{"anyOf":[{"type":"number"},{"type":"null"}]},"fiscal_period":{"anyOf":[{"type":"string"},{"type":"null"}]},"form":{"type":"string"},"filed":{"type":"string"},"frame":{"anyOf":[{"type":"string"},{"type":"null"}]},"accession":{"type":"string"}},"required":["value","start","end","fiscal_year","fiscal_period","form","filed","frame","accession"],"additionalProperties":false}}},"required":["tag","taxonomy","label","unit","count","series"],"additionalProperties":false},"source":{"type":"string","const":"sec_edgar"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/company-facts/{ticker}":{"get":{"operationId":"v1_company-facts_{ticker}","summary":"Every XBRL financial fact a company has reported to the SEC, each collapsed to its latest value: tag, taxonomy, label, unit, the figure, and the period/form/filing it came from. Filter with `?taxonomy=us-gaap|dei`, `?search=revenue`, and `?limit=`. Discover which metrics exist for a ticker before drilling into the full series via /concept. Sourced from SEC EDGAR. From x402stock","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"taxonomy","schema":{"type":"string"}},{"in":"query","name":"search","schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"default":50,"type":"integer","exclusiveMinimum":0,"maximum":500}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"entity_name":{"type":"string"},"cik":{"type":"string"},"taxonomy":{"type":"string"},"search":{"anyOf":[{"type":"string"},{"type":"null"}]},"total_facts":{"type":"number"},"count":{"type":"number"},"facts":{"type":"array","items":{"type":"object","properties":{"tag":{"type":"string"},"taxonomy":{"type":"string"},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"unit":{"anyOf":[{"type":"string"},{"type":"null"}]},"latest_value":{"type":"number"},"end":{"type":"string"},"fiscal_year":{"anyOf":[{"type":"number"},{"type":"null"}]},"fiscal_period":{"anyOf":[{"type":"string"},{"type":"null"}]},"form":{"type":"string"},"filed":{"type":"string"}},"required":["tag","taxonomy","label","unit","latest_value","end","fiscal_year","fiscal_period","form","filed"],"additionalProperties":false}}},"required":["entity_name","cik","taxonomy","search","total_facts","count","facts"],"additionalProperties":false},"source":{"type":"string","const":"sec_edgar"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/filing-summary/{ticker}":{"get":{"operationId":"v1_filing-summary_{ticker}","summary":"Fetches a company's latest 10-K, 10-Q, or 8-K from SEC EDGAR and returns a structured JSON summary: a plain-language overview, the key risk factors, MD&A highlights, any forward guidance, and an overall sentiment label. Choose the document with `?type=10-K` (also 10-Q, 8-K). Built for agents that need the substance of a filing without parsing hundreds of pages of HTML. From x402stock","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"type","schema":{"default":"10-K","type":"string","enum":["10-K","10-Q","8-K"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"form":{"type":"string"},"accession":{"type":"string"},"filing_date":{"type":"string"},"report_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"filing_url":{"type":"string"},"summary":{"type":"string"},"business_overview":{"anyOf":[{"type":"string"},{"type":"null"}]},"risk_factors":{"type":"array","items":{"type":"string"}},"mda_highlights":{"type":"array","items":{"type":"string"}},"guidance":{"anyOf":[{"type":"string"},{"type":"null"}]},"sentiment":{"anyOf":[{"type":"string","enum":["positive","neutral","negative"]},{"type":"null"}]}},"required":["form","accession","filing_date","report_date","filing_url","summary","business_overview","risk_factors","mda_highlights","guidance","sentiment"],"additionalProperties":false},"source":{"type":"string","const":"sec_edgar"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/congress-trades":{"get":{"operationId":"v1_congress-trades","summary":"Recent stock trades disclosed by US members of Congress under the STOCK Act, parsed live from official House and Senate Periodic Transaction Reports: per trade the member, chamber, ticker, asset, buy/sell type, date, and disclosed dollar range. ?chamber=house|senate|both, ?ticker=AAPL, ?limit= recent filings per chamber (max 20). From US House & Senate. From x402stock","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"limit","schema":{"default":7,"type":"integer","exclusiveMinimum":0,"maximum":20}},{"in":"query","name":"ticker","schema":{"type":"string","minLength":1,"maxLength":10}},{"in":"query","name":"chamber","schema":{"default":"house","type":"string","enum":["house","senate","both"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","enum":["us_house","us_senate","us_congress"]},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}]},"chamber":{"type":"string","enum":["house","senate","both"]},"disclosure":{"type":"string"},"trade_count":{"type":"number"},"trades":{"type":"array","items":{"type":"object","properties":{"chamber":{"type":"string","enum":["house","senate"]},"member":{"type":"string"},"state":{"type":"string"},"district":{"type":"string"},"filing_date":{"type":"string"},"doc_id":{"type":"string"},"pdf_url":{"type":"string"},"asset":{"type":"string"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}]},"asset_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"owner":{"anyOf":[{"type":"string"},{"type":"null"}]},"transaction_type":{"type":"string"},"transaction_code":{"type":"string"},"transaction_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"notification_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"amount_range":{"type":"string"},"amount_min":{"anyOf":[{"type":"number"},{"type":"null"}]},"amount_max":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["chamber","member","state","district","filing_date","doc_id","pdf_url","asset","ticker","asset_type","owner","transaction_type","transaction_code","transaction_date","notification_date","amount_range","amount_min","amount_max"],"additionalProperties":false}}},"required":["source","as_of","chamber","disclosure","trade_count","trades"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/treasury-yields":{"get":{"operationId":"v1_treasury-yields","summary":"The daily US Treasury par yield curve (Constant Maturity Treasury rates) for every maturity from 1 month to 30 years, in percent. Defaults to the latest published day; pass `?limit=` for more recent days (max 250) and `?year=YYYY`. No ticker needed. Use for the risk-free rate, rate-sensitivity context, and yield-curve inversion in macro-aware analysis. From x402stock","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"limit","schema":{"default":1,"type":"integer","exclusiveMinimum":0,"maximum":250}},{"in":"query","name":"year","schema":{"type":"integer","minimum":1990,"maximum":2100}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"us_treasury"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}]},"series":{"type":"string"},"unit":{"type":"string"},"maturities":{"type":"array","items":{"type":"string"}},"count":{"type":"number"},"rates":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"rates":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"number"},{"type":"null"}]}}},"required":["date","rates"],"additionalProperties":false}}},"required":["source","as_of","series","unit","maturities","count","rates"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/trending/reddit":{"get":{"operationId":"v1_trending_reddit","summary":"What stocks and crypto Reddit is talking about most over the last 24h, by mention volume across the busiest Reddit money subreddits (r/wallstreetbets, r/stocks, r/CryptoCurrency, r/Bitcoin, etc.). Each ticker carries mentions, upvotes, and 24h change in rank and mentions; covered subreddits are listed per response. ?filter=stocks|crypto|all (default all), ?page=. From x402stock","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"filter","schema":{"default":"all","type":"string","enum":["all","stocks","crypto"]}},{"in":"query","name":"page","schema":{"default":1,"type":"integer","exclusiveMinimum":0,"maximum":100}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"},"platform":{"type":"string","const":"reddit"},"filter":{"type":"string","enum":["all","stocks","crypto"]},"window":{"type":"string","const":"24h"},"communities":{"type":"array","items":{"type":"string"}},"page":{"type":"number"},"pages":{"type":"number"},"count":{"type":"number"},"results":{"type":"array","items":{"type":"object","properties":{"rank":{"anyOf":[{"type":"number"},{"type":"null"}]},"ticker":{"type":"string"},"name":{"type":"string"},"mentions":{"anyOf":[{"type":"number"},{"type":"null"}]},"upvotes":{"anyOf":[{"type":"number"},{"type":"null"}]},"rank_24h_ago":{"anyOf":[{"type":"number"},{"type":"null"}]},"mentions_24h_ago":{"anyOf":[{"type":"number"},{"type":"null"}]},"mentions_change":{"anyOf":[{"type":"number"},{"type":"null"}]},"mentions_change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"rank_change":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["rank","ticker","name","mentions","upvotes","rank_24h_ago","mentions_24h_ago","mentions_change","mentions_change_percent","rank_change"],"additionalProperties":false}}},"required":["source","as_of","platform","filter","window","communities","page","pages","count","results"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/trending/4chan":{"get":{"operationId":"v1_trending_4chan","summary":"What tickers 4chan's finance board (/biz/) is buzzing about most over the last 24h, ranked by mention volume. Each ticker carries its mention count and 24h change in rank and mentions (4chan has no upvotes, so upvotes is always 0). No ticker needed; ?page= to paginate (100 per page). A raw read of /biz/ chatter, separate from the Reddit feed. From x402stock","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"page","schema":{"default":1,"type":"integer","exclusiveMinimum":0,"maximum":100}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"},"platform":{"type":"string","const":"4chan"},"board":{"type":"string","const":"/biz/"},"window":{"type":"string","const":"24h"},"page":{"type":"number"},"pages":{"type":"number"},"count":{"type":"number"},"results":{"type":"array","items":{"type":"object","properties":{"rank":{"anyOf":[{"type":"number"},{"type":"null"}]},"ticker":{"type":"string"},"name":{"type":"string"},"mentions":{"anyOf":[{"type":"number"},{"type":"null"}]},"upvotes":{"anyOf":[{"type":"number"},{"type":"null"}]},"rank_24h_ago":{"anyOf":[{"type":"number"},{"type":"null"}]},"mentions_24h_ago":{"anyOf":[{"type":"number"},{"type":"null"}]},"mentions_change":{"anyOf":[{"type":"number"},{"type":"null"}]},"mentions_change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"rank_change":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["rank","ticker","name","mentions","upvotes","rank_24h_ago","mentions_24h_ago","mentions_change","mentions_change_percent","rank_change"],"additionalProperties":false}}},"required":["source","as_of","platform","board","window","page","pages","count","results"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/forex/{pair}/aggregates":{"get":{"operationId":"v1_forex_{pair}_aggregates","summary":"Historical OHLCV bars for a foreign-exchange pair at the requested multiplier and timespan (minute, hour, day, week, month) between `from` and `to`. Pass the pair in the path as BASE-QUOTE, e.g. EUR-USD or USD-JPY. Use for FX charting, backtesting, and macro/rate analysis. From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"multiplier","schema":{"default":1,"type":"integer","exclusiveMinimum":0,"maximum":50000}},{"in":"query","name":"timespan","schema":{"default":"day","type":"string","enum":["minute","hour","day","week","month","quarter","year"]}},{"in":"query","name":"from","schema":{"default":"2025-06-03","type":"string","minLength":1}},{"in":"query","name":"to","schema":{"default":"2026-06-03","type":"string","minLength":1}},{"in":"query","name":"adjusted","schema":{"default":true,"type":"boolean"}},{"in":"query","name":"sort","schema":{"default":"asc","type":"string","enum":["asc","desc"]}},{"in":"query","name":"limit","schema":{"default":5000,"type":"integer","exclusiveMinimum":0,"maximum":50000}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"bars":{"type":"array","items":{"type":"object","properties":{"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"vwap":{"anyOf":[{"type":"number"},{"type":"null"}]},"trade_count":{"anyOf":[{"type":"number"},{"type":"null"}]},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["open","high","low","close","volume","vwap","trade_count","timestamp"],"additionalProperties":false}},"count":{"type":"number"},"adjusted":{"type":"boolean"}},"required":["bars","count"],"additionalProperties":false},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/forex/{pair}/prev-close":{"get":{"operationId":"v1_forex_{pair}_prev-close","summary":"Open, high, low, close, volume, and VWAP for a foreign-exchange pair's most recent completed trading day. Pass the pair in the path as BASE-QUOTE, e.g. EUR-USD. One call returns one bar for a quick prior-close reference. From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"anyOf":[{"type":"object","properties":{"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"vwap":{"anyOf":[{"type":"number"},{"type":"null"}]},"trade_count":{"anyOf":[{"type":"number"},{"type":"null"}]},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["open","high","low","close","volume","vwap","trade_count","timestamp"],"additionalProperties":false},{"type":"null"}]},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/crypto/{pair}/aggregates":{"get":{"operationId":"v1_crypto_{pair}_aggregates","summary":"Historical OHLCV bars for a crypto spot pair at the requested multiplier and timespan (minute, hour, day, week, month) between `from` and `to`. Pass the pair in the path as BASE-QUOTE, e.g. BTC-USD or ETH-USD. Use for crypto charting, backtesting, and trend analysis. Spot only (no perps/funding). From x402stock, a US stock market data API. Pay per request in USDC via x402, no API key.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"multiplier","schema":{"default":1,"type":"integer","exclusiveMinimum":0,"maximum":50000}},{"in":"query","name":"timespan","schema":{"default":"day","type":"string","enum":["minute","hour","day","week","month","quarter","year"]}},{"in":"query","name":"from","schema":{"default":"2025-06-03","type":"string","minLength":1}},{"in":"query","name":"to","schema":{"default":"2026-06-03","type":"string","minLength":1}},{"in":"query","name":"adjusted","schema":{"default":true,"type":"boolean"}},{"in":"query","name":"sort","schema":{"default":"asc","type":"string","enum":["asc","desc"]}},{"in":"query","name":"limit","schema":{"default":5000,"type":"integer","exclusiveMinimum":0,"maximum":50000}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"bars":{"type":"array","items":{"type":"object","properties":{"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"vwap":{"anyOf":[{"type":"number"},{"type":"null"}]},"trade_count":{"anyOf":[{"type":"number"},{"type":"null"}]},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["open","high","low","close","volume","vwap","trade_count","timestamp"],"additionalProperties":false}},"count":{"type":"number"},"adjusted":{"type":"boolean"}},"required":["bars","count"],"additionalProperties":false},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/crypto/{pair}/prev-close":{"get":{"operationId":"v1_crypto_{pair}_prev-close","summary":"Crypto trades 24/7, so there is no session close: this returns the previous UTC calendar day's full OHLCV candle (00:00–24:00 UTC) for a spot pair — open, high, low, close, volume, and VWAP. Pass the pair in the path as BASE-QUOTE, e.g. BTC-USD. One call returns yesterday's daily bar. From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"anyOf":[{"type":"object","properties":{"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"vwap":{"anyOf":[{"type":"number"},{"type":"null"}]},"trade_count":{"anyOf":[{"type":"number"},{"type":"null"}]},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["open","high","low","close","volume","vwap","trade_count","timestamp"],"additionalProperties":false},{"type":"null"}]},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/crypto/{pair}/open-close":{"get":{"operationId":"v1_crypto_{pair}_open-close","summary":"The official UTC open and close price for a crypto spot pair on a given date. Pass the pair in the path as BASE-QUOTE, e.g. BTC-USD, and the date via `?date=YYYY-MM-DD` (required). Crypto trades 24/7, so this is the UTC-day open/close. From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"date","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"date":{"anyOf":[{"type":"string"},{"type":"null"}]},"open":{"type":"number"},"close":{"type":"number"}},"required":["date","open","close"],"additionalProperties":false},"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/screener":{"get":{"operationId":"v1_screener","summary":"Screen the entire US stock market in one call. Filter every listed ticker by price range, percent change, and minimum volume, then sort by percent move, price, or volume. Tune with ?min_price=, ?max_price=, ?min_change_percent=, ?max_change_percent=, ?min_volume=, ?sort=, ?order=, ?limit=. Built for agents scanning for setups without iterating ticker by ticker. From x402stock","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"min_price","schema":{"type":"number","minimum":0}},{"in":"query","name":"max_price","schema":{"type":"number","minimum":0}},{"in":"query","name":"min_change_percent","schema":{"type":"number"}},{"in":"query","name":"max_change_percent","schema":{"type":"number"}},{"in":"query","name":"min_volume","schema":{"type":"number","minimum":0}},{"in":"query","name":"sort","schema":{"default":"change_percent","type":"string","enum":["change_percent","price","volume"]}},{"in":"query","name":"order","schema":{"default":"desc","type":"string","enum":["asc","desc"]}},{"in":"query","name":"limit","schema":{"default":50,"type":"integer","exclusiveMinimum":0,"maximum":500}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"x402stock"},"as_of":{"type":"string"},"universe":{"type":"number"},"matched":{"type":"number"},"sort":{"type":"string","enum":["change_percent","price","volume"]},"order":{"type":"string","enum":["asc","desc"]},"count":{"type":"number"},"results":{"type":"array","items":{"type":"object","properties":{"ticker":{"type":"string"},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"change":{"anyOf":[{"type":"number"},{"type":"null"}]},"change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"volume":{"anyOf":[{"type":"number"},{"type":"null"}]},"vwap":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["ticker","price","change","change_percent","volume","vwap"],"additionalProperties":false}}},"required":["source","as_of","universe","matched","sort","order","count","results"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/filing-search":{"get":{"operationId":"v1_filing-search","summary":"Full-text search across every SEC EDGAR filing since 2001. Find filings mentioning a keyword or exact phrase via ?q=, narrow by ?forms=10-K,8-K, ?ticker=, and ?startdt=/?enddt= dates, and cap with ?limit=. Returns each match's form, filer, date, and a link to the document. Sourced from SEC EDGAR. From x402stock, a US stock market data API. Pay per request in USDC via x402, no API key.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"q","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"forms","schema":{"type":"string"}},{"in":"query","name":"ticker","schema":{"type":"string"}},{"in":"query","name":"startdt","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"enddt","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","exclusiveMinimum":0,"maximum":100}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"sec_edgar"},"as_of":{"type":"string"},"query":{"type":"string"},"forms":{"anyOf":[{"type":"string"},{"type":"null"}]},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}]},"total_matches":{"type":"number"},"count":{"type":"number"},"results":{"type":"array","items":{"type":"object","properties":{"accession":{"anyOf":[{"type":"string"},{"type":"null"}]},"form":{"anyOf":[{"type":"string"},{"type":"null"}]},"filing_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"period_ending":{"anyOf":[{"type":"string"},{"type":"null"}]},"filer":{"anyOf":[{"type":"string"},{"type":"null"}]},"cik":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["accession","form","filing_date","period_ending","filer","cik","description","url"],"additionalProperties":false}}},"required":["source","as_of","query","forms","ticker","total_matches","count","results"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/frames":{"get":{"operationId":"v1_frames","summary":"One reported XBRL financial fact for every company that disclosed it in a calendar period, for peer screening. Pass ?tag= (e.g. Revenues), ?period= (CY2024, CY2024Q1, or CY2024Q1I for balance-sheet facts), ?taxonomy= (default us-gaap), ?unit= (default USD), and ?limit=. Sorted by value. Sourced from SEC EDGAR. From x402stock, a US stock market data API (x402, USDC).","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"tag","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"period","schema":{"type":"string","pattern":"^CY\\d{4}(Q[1-4]I?)?$"},"required":true},{"in":"query","name":"taxonomy","schema":{"default":"us-gaap","type":"string"}},{"in":"query","name":"unit","schema":{"default":"USD","type":"string"}},{"in":"query","name":"limit","schema":{"default":50,"type":"integer","exclusiveMinimum":0,"maximum":500}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"sec_edgar"},"as_of":{"type":"string"},"tag":{"type":"string"},"taxonomy":{"type":"string"},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"unit":{"type":"string"},"period":{"type":"string"},"total_filers":{"type":"number"},"count":{"type":"number"},"data":{"type":"array","items":{"type":"object","properties":{"cik":{"type":"string"},"entity":{"type":"string"},"value":{"type":"number"},"start":{"anyOf":[{"type":"string"},{"type":"null"}]},"end":{"type":"string"},"accession":{"type":"string"}},"required":["cik","entity","value","start","end","accession"],"additionalProperties":false}}},"required":["source","as_of","tag","taxonomy","label","unit","period","total_filers","count","data"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/form-3/{ticker}":{"get":{"operationId":"v1_form-3_{ticker}","summary":"Initial beneficial-ownership holdings parsed from SEC Form 3 filings, the first report an insider files on becoming a director, officer, or 10% holder. Each holding carries the security, shares owned, direct or indirect ownership, and derivative terms. Complements Form 4 transactions. ?limit= filings (default 5). Sourced from SEC EDGAR. From x402stock, a US stock market data API (x402, USDC).","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"limit","schema":{"default":5,"type":"integer","exclusiveMinimum":0,"maximum":25}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"data":{"type":"object","properties":{"filings_parsed":{"type":"number"},"holding_count":{"type":"number"},"holdings":{"type":"array","items":{"type":"object","properties":{"owner_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"is_director":{"type":"boolean"},"is_officer":{"type":"boolean"},"officer_title":{"anyOf":[{"type":"string"},{"type":"null"}]},"is_ten_percent_owner":{"type":"boolean"},"filing_date":{"type":"string"},"accession":{"type":"string"},"url":{"type":"string"},"security":{"anyOf":[{"type":"string"},{"type":"null"}]},"shares":{"anyOf":[{"type":"number"},{"type":"null"}]},"direct_or_indirect":{"anyOf":[{"type":"string","enum":["D","I"]},{"type":"null"}]},"nature_of_ownership":{"anyOf":[{"type":"string"},{"type":"null"}]},"is_derivative":{"type":"boolean"},"exercise_price":{"anyOf":[{"type":"number"},{"type":"null"}]},"exercise_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiration_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"underlying_security":{"anyOf":[{"type":"string"},{"type":"null"}]},"underlying_shares":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["owner_name","is_director","is_officer","officer_title","is_ten_percent_owner","filing_date","accession","url","security","shares","direct_or_indirect","nature_of_ownership","is_derivative","exercise_price","exercise_date","expiration_date","underlying_security","underlying_shares"],"additionalProperties":false}}},"required":["filings_parsed","holding_count","holdings"],"additionalProperties":false},"source":{"type":"string","const":"sec_edgar"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["ticker","data","source","as_of"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/fund-holdings/{cik}":{"get":{"operationId":"v1_fund-holdings_{cik}","summary":"The latest 13F-HR institutional holdings for a fund or investment manager, looked up by its SEC CIK. Returns every reported position with issuer, CUSIP, market value, share count, option type, and voting authority, plus the portfolio's total value, sorted largest first. ?limit= positions. Sourced from SEC EDGAR. From x402stock, a US stock market data API (x402, USDC).","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"limit","schema":{"default":100,"type":"integer","exclusiveMinimum":0,"maximum":1000}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"cik":{"type":"string"},"filer":{"type":"string"},"source":{"type":"string","const":"sec_edgar"},"as_of":{"type":"string"},"data":{"type":"object","properties":{"form":{"type":"string"},"accession":{"type":"string"},"filing_date":{"type":"string"},"report_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"total_positions":{"type":"number"},"total_value":{"type":"number"},"count":{"type":"number"},"holdings":{"type":"array","items":{"type":"object","properties":{"issuer":{"anyOf":[{"type":"string"},{"type":"null"}]},"title_of_class":{"anyOf":[{"type":"string"},{"type":"null"}]},"cusip":{"anyOf":[{"type":"string"},{"type":"null"}]},"value":{"anyOf":[{"type":"number"},{"type":"null"}]},"shares":{"anyOf":[{"type":"number"},{"type":"null"}]},"shares_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"put_call":{"anyOf":[{"type":"string"},{"type":"null"}]},"investment_discretion":{"anyOf":[{"type":"string"},{"type":"null"}]},"voting_sole":{"anyOf":[{"type":"number"},{"type":"null"}]},"voting_shared":{"anyOf":[{"type":"number"},{"type":"null"}]},"voting_none":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["issuer","title_of_class","cusip","value","shares","shares_type","put_call","investment_discretion","voting_sole","voting_shared","voting_none"],"additionalProperties":false}}},"required":["form","accession","filing_date","report_date","total_positions","total_value","count","holdings"],"additionalProperties":false}},"required":["cik","filer","source","as_of","data"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/fails-to-deliver/{ticker}":{"get":{"operationId":"v1_fails-to-deliver_{ticker}","summary":"Settlement fails-to-deliver for a US-listed stock from the SEC's semi-monthly data: the aggregate shares that failed to deliver on each settlement date, with the reference price, most recent first. A niche short-pressure and squeeze signal. ?limit= records (default 30). Sourced from SEC EDGAR. From x402stock, a US stock market data API. Pay per request in USDC via x402, no API key.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"parameters":[{"in":"query","name":"limit","schema":{"default":30,"type":"integer","exclusiveMinimum":0,"maximum":120}},{"in":"query","name":"periods","schema":{"default":2,"type":"integer","exclusiveMinimum":0,"maximum":6}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"sec_edgar"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"type":"string"},"periods_read":{"type":"number"},"count":{"type":"number"},"note":{"type":"string"},"fails":{"type":"array","items":{"type":"object","properties":{"settlement_date":{"type":"string"},"cusip":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"type":"string"},"fails":{"anyOf":[{"type":"number"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["settlement_date","cusip","symbol","fails","description","price"],"additionalProperties":false}}},"required":["source","as_of","symbol","periods_read","count","note","fails"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/inflation":{"get":{"operationId":"v1_inflation","summary":"US consumer price inflation from the Bureau of Labor Statistics: the latest headline CPI-U and core (ex food and energy) index levels with year-over-year percent change, plus recent monthly history. No ticker needed. Use for macro-aware analysis without leaving for a separate data source. Sourced from US BLS. From x402stock, a US stock market data API (x402, USDC).","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"us_bls"},"as_of":{"type":"string"},"series":{"type":"string"},"unit":{"type":"string"},"headline":{"type":"object","properties":{"latest_index":{"anyOf":[{"type":"number"},{"type":"null"}]},"latest_month":{"anyOf":[{"type":"string"},{"type":"null"}]},"yoy_percent":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["latest_index","latest_month","yoy_percent"],"additionalProperties":false},"core":{"type":"object","properties":{"latest_index":{"anyOf":[{"type":"number"},{"type":"null"}]},"latest_month":{"anyOf":[{"type":"string"},{"type":"null"}]},"yoy_percent":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["latest_index","latest_month","yoy_percent"],"additionalProperties":false},"history":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"period_name":{"type":"string"},"value":{"type":"number"}},"required":["date","period_name","value"],"additionalProperties":false}}},"required":["source","as_of","series","unit","headline","core","history"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/v1/labor-market":{"get":{"operationId":"v1_labor-market","summary":"US labor-market headline indicators from the Bureau of Labor Statistics: the unemployment rate, labor force participation rate, total nonfarm payrolls, and average hourly earnings, each with its latest value and change from the prior month. No ticker needed. Sourced from US BLS. From x402stock, a pay-per-call US stock market data API. No API key or account; pay per request in USDC via x402.","tags":["V1"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","const":"us_bls"},"as_of":{"type":"string"},"series":{"type":"string"},"metrics":{"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"unit":{"type":"string"},"latest_value":{"anyOf":[{"type":"number"},{"type":"null"}]},"latest_month":{"anyOf":[{"type":"string"},{"type":"null"}]},"prior_value":{"anyOf":[{"type":"number"},{"type":"null"}]},"change":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["metric","unit","latest_value","latest_month","prior_value","change"],"additionalProperties":false}}},"required":["source","as_of","series","metrics"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}}}}