All endpoints are under /api/v1 and return JSON shaped { ticker, data, source: 'x402stock', as_of }.
Paid 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.
Where a path contains {ticker}, pass a US-listed ticker symbol in uppercase (e.g. AAPL).

Endpoints (price per request):
- /api/v1/overview/{ticker} ($0.05): Everything about one stock in one call: profile, price, fundamentals, technicals, news, peers
- /api/v1/compare ($0.05): Compare 2 to 3 stocks side by side: price, P/E, market cap, margins, yield
- /api/v1/technicals/{ticker} ($0.03): Technical indicators in one call: RSI, SMA, EMA, MACD with signal zones
- /api/v1/market-pulse ($0.03): Market movers in one call: top gainers, top losers, market status, news
- /api/v1/quote/{ticker} ($0.01): Last price for a US stock, 15 minute delayed
- /api/v1/snapshot/{ticker} ($0.01): Full ticker snapshot (last quote, last trade, OHLC, prev close, %change)
- /api/v1/aggregates/{ticker} ($0.02): Historical price history: OHLC bars over any timespan and date range
- /api/v1/news ($0.02): Latest news articles, optionally filtered by ticker
- /api/v1/ticker/{ticker} ($0.01): Company / ticker reference data
- /api/v1/prev-close/{ticker} ($0.01): Previous trading day OHLC bar
- /api/v1/open-close/{ticker} ($0.01): Daily open/close (+ pre/after-hours) for a specific date
- /api/v1/dividends/{ticker} ($0.01): Dividend history (cash amount, ex-date, pay date, frequency)
- /api/v1/splits/{ticker} ($0.01): Stock split history
- /api/v1/financials/{ticker} ($0.02): Fundamentals: income, balance sheet, and cash flow statements
- /api/v1/events/{ticker} ($0.01): Corporate events (ticker changes and more)
- /api/v1/related/{ticker} ($0.01): Related peer companies
- /api/v1/indicators/sma/{ticker} ($0.01): Simple Moving Average (SMA)
- /api/v1/indicators/ema/{ticker} ($0.01): Exponential Moving Average (EMA)
- /api/v1/indicators/rsi/{ticker} ($0.01): Relative Strength Index (RSI)
- /api/v1/indicators/macd/{ticker} ($0.01): Moving Average Convergence/Divergence (MACD)
- /api/v1/gainers ($0.02): Top gaining US stocks today
- /api/v1/losers ($0.02): Top losing US stocks today
- /api/v1/grouped-daily ($0.02): Whole-market daily OHLC for one date
- /api/v1/full-market-snapshot ($0.04): Whole-market snapshot: every US ticker's current price and day change in one call
- /api/v1/unified-snapshot ($0.02): Multi-ticker snapshot: fetch a whole watchlist's prices in one call
- /api/v1/options/{ticker} ($0.02): Options chain for a US stock: every contract with strike, expiration, and call/put type
- /api/v1/options-aggregates/{contract} ($0.02): Historical OHLC bars for a single option contract
- /api/v1/short-interest/{ticker} ($0.02): Bi-weekly short interest and days-to-cover for a stock
- /api/v1/short-volume/{ticker} ($0.02): Daily short-sale volume and short-volume ratio for a stock
- /api/v1/ipos ($0.02): IPO calendar: upcoming and historical US listings with price range and size
- /api/v1/forex/{pair}/aggregates ($0.02): Forex price history: OHLC bars for a currency pair over any timespan and date range
- /api/v1/forex/{pair}/prev-close ($0.01): Previous day OHLC bar for a currency pair
- /api/v1/crypto/{pair}/aggregates ($0.02): Crypto price history: OHLC bars for a spot pair over any timespan and date range
- /api/v1/crypto/{pair}/prev-close ($0.01): Previous UTC-day OHLC candle for a crypto spot pair
- /api/v1/crypto/{pair}/open-close ($0.01): Daily open and close for a crypto spot pair on a specific date
- /api/v1/screener ($0.03): Screen the whole US market: filter every ticker by price, percent move, and volume in one call
- /api/v1/exchanges ($0.01): US stock exchanges & market centers reference
- /api/v1/conditions ($0.01): Trade & quote condition codes reference
- /api/v1/ticker-types ($0.01): Ticker type codes reference (CS, ETF, ADRC, …)
- /api/v1/tickers ($0.01): Search / list tickers across stocks, crypto, forex, and indices
- /api/v1/filings/{ticker} ($0.01): SEC filing history for a company: 10-K, 10-Q, 8-K, Form 4, and more
- /api/v1/insider-trades/{ticker} ($0.03): Insider transactions from SEC Form 4: who bought or sold, how much, at what price
- /api/v1/material-events/{ticker} ($0.03): Material corporate events from 8-K filings, classified by SEC item code
- /api/v1/concept/{ticker} ($0.02): Time series of a single XBRL financial fact straight from SEC filings
- /api/v1/company-facts/{ticker} ($0.02): Every reported financial fact for a company, latest value each, straight from SEC XBRL
- /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
- /api/v1/filing-search ($0.02): Full-text search across all SEC filings since 2001 by keyword, form type, and date
- /api/v1/frames ($0.02): Compare one financial metric across every public company for a single period
- /api/v1/form-3/{ticker} ($0.02): Initial insider ownership from SEC Form 3: holdings reported when an insider role begins
- /api/v1/fund-holdings/{cik} ($0.03): Institutional 13F holdings for a fund by CIK: every position, value, and shares
- /api/v1/fails-to-deliver/{ticker} ($0.02): Fails-to-deliver history for a stock: settlement-fail share volume by date
- /api/v1/congress-trades ($0.03): US congressional stock trades (House & Senate) from STOCK Act disclosures: who traded what, when, and how much
- /api/v1/treasury-yields ($0.01): US Treasury par yield curve (1mo to 30yr) for the latest day or a date range
- /api/v1/inflation ($0.02): US CPI inflation: headline and core index with year-over-year percent
- /api/v1/labor-market ($0.02): US labor market: unemployment, participation, payrolls, and wage growth
- /api/v1/trending/reddit ($0.01): Trending tickers on Reddit (last 24h): the most-mentioned stocks, crypto, or both
- /api/v1/trending/4chan ($0.01): Trending tickers on 4chan /biz/ (last 24h): the most-mentioned by post volume
- /api/v1/market-status (free): Current US market status (open / closed / pre / post)
- /api/v1/market-holidays (free): Upcoming US market holidays & early closes

Machine-readable spec: /openapi.json. Payable resource catalog: /.well-known/x402 (also /.well-known/x402.json).