market & economic data.
US stocks, options, forex, crypto and on-chain perps, energy commodities, US and global macro, SEC filings, congressional trades, and market sentiment — built for AI agents. No API keys, no accounts. Your agent pays a few cents per request in USDC and gets clean JSON back.
- 136
- endpoints
- $0.01
- starting price
- 0
- API keys
- 100%
- US market coverage
Call it from any x402-aware agent
x402stock is plain HTTP + the x402 payment standard — any agent with a USDC wallet can pay and call it. No SDK lock-in, no accounts.
Top offerings #
The highest-value calls on the API — each one bundles or computes what would otherwise take an agent a dozen requests.
all 136 endpoints →
AI Research Report
One call fans out across ~16 sources and an LLM writes the bull/bear case, valuation, catalysts, risks & signal read-out.
Stock Overview
Profile, price, fundamentals, technicals, news & peers for one ticker — in a single call.
AI Filing Summary
10-K / 10-Q / 8-K distilled to overview, risks, MD&A, and guidance as structured JSON.
Compare Stocks
2–3 tickers side by side: price, P/E, market cap, margins, and yield.
Insider Trades
Form 4 buys & sells with role, size, price, and a net-buying signal.
Technicals Pack
RSI, SMA, EMA, and MACD with signal zones in one momentum read.
Market Pulse
Top gainers, top losers, session status, and headlines — no ticker needed.
Try it with AgentCash #
Point any x402-aware agent at a URL and it just works. The wallet handles the 402 challenge, signs a gasless USDC transfer, and retries. Works from AgentCash, Claude Code, Cursor, or Codex.
npx agentcash onboard
npx agentcash fetch https://x402stock.xyz/api/v1/market-status
npx agentcash accounts
npx agentcash fetch https://x402stock.xyz/api/v1/quote/AAPL
npx agentcash add https://x402stock.xyz
What your agent can ask once it's added #
Out of the box, an agent answers stock questions from stale training data — no live prices, no SEC filings, no idea what moved this week. Add x402stock through AgentCash and these become answerable — each one backed by a live call your agent pays a few cents for, on demand.
- ›_ Research MU's outlook into 2028. Has there been any insider buying lately?
Live fundamentals and price, recent news, plus parsed Form 4 insider buys and sells with a net signal.
Overview + Insiders/overview/{ticker}$0.05/insider-trades/{ticker}$0.03/news$0.02 - ›_ What stocks have members of Congress been buying or selling lately?
STOCK Act disclosures parsed live from House and Senate filings — member, ticker, buy/sell, date, and dollar range. No model knows this; it only exists in this week's filings.
Congress Trades/congress-trades$0.03 - ›_ Is the market in fear or greed right now?
Today's CNN-style Fear & Greed score with all five components and a forward-return backtest. A point-in-time reading training data can't have.
Fear & Greed/fear-greed$0.02 - ›_ Where's the 10-year Treasury yield and what's CPI inflation now?
The current Treasury par-yield curve and the latest BLS CPI print — the live macro backdrop an agent otherwise has to guess at from stale numbers.
Live Macro/treasury-yields$0.01/inflation$0.02 - ›_ What's the current Fed funds rate and the latest US GDP print?
The effective federal funds rate and latest real GDP straight from FRED, with the change — today's values, not a last-year training snapshot.
Fed & GDP/fed-funds$0.01/gdp$0.01 - ›_ What's BTC's perp funding rate and open interest right now?
Live on-chain funding rate, annualized APR, and open interest from Hyperliquid — derivatives signals that exist nowhere in a model's weights.
Perp Funding/perps/{coin}$0.01/perps/funding/{coin}$0.01 - ›_ Which tickers is wallstreetbets talking about most today?
The most-mentioned stocks and crypto across the busiest money subreddits over the last 24h, ranked by volume. A live read of right-now retail attention.
Reddit Trending/trending/reddit$0.01 - ›_ Is GME a short-squeeze setup? Show short interest and days to cover.
Exchange-reported bi-weekly short interest plus daily short-volume ratio — the squeeze signal you can't infer, only pull from the latest FINRA settlement.
Short Interest/short-interest/{ticker}$0.02/short-volume/{ticker}$0.02 - ›_ Summarize NVDA's latest 10-K. What are the biggest risk factors and any forward guidance?
An AI-structured summary of the filing: overview, risks, MD&A, and guidance, straight from SEC EDGAR.
AI Filing Summary/filing-summary/{ticker}$0.03 - ›_ Compare AAPL, MSFT and NVDA on P/E, market cap, margins and dividend yield.
All three side by side from one call, no juggling a dozen requests.
Compare Stocks/compare$0.05 - ›_ Is TSLA overbought right now? Show me RSI, MACD and the moving averages.
Live technical indicators with overbought/oversold and signal-cross zones, not a guess.
Technicals/technicals/{ticker}$0.03 - ›_ What were today's biggest movers, and what's the market doing right now?
Top gainers and losers, the current session status, and the day's headlines. No ticker needed.
Market Pulse/market-pulse$0.03 - ›_ Chart TSLA's daily closing prices over the past year.
Historical OHLC bars over any timespan and date range, ready for trend analysis or backtesting.
Price History/aggregates/{ticker}$0.02 - ›_ What's AAPL trading at right now, and how has it moved today?
The latest delayed price with today's OHLCV, the change, and the previous close in one snapshot.
Live Quote/quote/{ticker}$0.01/snapshot/{ticker}$0.01 - ›_ Which US stocks are up the most today, and which are down the hardest?
The day's biggest percentage gainers and losers across US equities, with OHLCV per ticker.
Gainers & Losers/gainers$0.02/losers$0.02 - ›_ What's the latest news on NVDA this week?
Curated market headlines tagged by ticker, with source, publisher, image, and timestamps.
Ticker News/news$0.02 - ›_ Did any PLTR insiders sell recently, and what 8-K events has AMD filed?
Form 4 transactions for one and item-classified 8-K material events for the other, both live from EDGAR.
Insiders + 8-K Events/insider-trades/{ticker}$0.03/material-events/{ticker}$0.03 - ›_ List GOOGL's recent SEC filings: 10-Ks, 10-Qs and 8-Ks.
A company's recent SEC EDGAR filings with form type, dates, 8-K item codes, and document links.
Filing History/filings/{ticker}$0.01 - ›_ Pull MSFT's quarterly revenue and net income straight from its SEC filings.
Filing-grade XBRL fact time series (Revenues, NetIncomeLoss) taken directly from EDGAR.
XBRL Financials/concept/{ticker}$0.02/financials/{ticker}$0.02 - ›_ Pull AMZN's annual income statement, balance sheet and cash flow.
Per-period income, balance sheet, and cash flow statements sourced straight from SEC filings.
Financial Statements/financials/{ticker}$0.02 - ›_ Show me AAPL's dividend history and any stock splits.
Cash dividend schedule with ex and pay dates plus the full split history.
Corporate Actions/dividends/{ticker}$0.01/splits/{ticker}$0.01 - ›_ Plot 50-day and 200-day moving averages for SPY.
SMA and EMA time series you can tune by window and timespan for a clean trend read.
Moving Averages/indicators/sma/{ticker}$0.01/indicators/ema/{ticker}$0.01 - ›_ Who are NVDA's closest peers to compare it against?
A quick peer set based on news and analyst-coverage co-occurrence, ready to feed a comparison.
Peers/related/{ticker}$0.01 - ›_ Find the ticker for Eli Lilly and pull its company profile.
Search US-listed tickers by name or symbol, then resolve exchange, market cap, and sector code.
Ticker Search/tickers$0.01/ticker/{ticker}$0.01 - ›_ Is the US market open right now, and when's the next holiday close?
Live session status plus upcoming market holidays and early closes. Both endpoints are free.
Market Hours/market-status$free/market-holidays$free
Wire it in once with npx agentcash add https://x402stock.xyz
and your agent reuses it for every question after.
How it works #
The whole flow is one HTTP round-trip the agent's wallet completes automatically.
-
01Request Agent calls an endpoint with no payment header.
-
02402 challenge Server replies HTTP 402 with the asset, amount, and payTo.
-
03Sign & retry Wallet signs a gasless USDC transfer and retries the request.
-
04Settle & serve Facilitator settles on Base; the handler returns JSON.
Full catalog #
133 paid endpoints from $0.01, plus free market status. Every response is shaped { ticker, data, source, as_of }
.
AI research & scores
A tier above resale: one call that scores or synthesizes across the whole catalog. An AI research memo, transparent 0–100 squeeze / insider / factor scores, a portfolio risk x-ray, and a plain-English screener.
AI equity-research report: bull/bear case, valuation, catalysts, risks, and a per-signal read-out for one stock
Short-squeeze score (0–100): a weighted gauge of short interest, days-to-cover, short volume, FTDs and spark
Insider-conviction score (0–100): net Form 4 flow, role weighting, cluster buys, Form 144 and 13D
Quant factor score: value, quality, growth and momentum sub-scores plus a composite (0–100)
Portfolio risk x-ray: concentration, sector & market-cap exposure, and weighted performance in one call
Natural-language stock screener: describe what you want, get a ranked shortlist with per-name rationale
Deliverable reports (PNG)
Pay and get a hosted image back, not just JSON: an equity tearsheet and a strategy backtest — each rendered as a one-page PNG report you get a URL to, plus the underlying data as JSON.
Equity tearsheet: a rendered one-page PNG report (price chart + stats) you get a URL to
Strategy backtest rendered as an equity-curve PNG report (vs buy & hold) you get a URL to
Prices & snapshots
Last price, full snapshots, daily bars, and the day's movers.
Last price for a US stock, 15 minute delayed
Full ticker snapshot (last quote, last trade, OHLC, prev close, %change)
Previous trading day OHLC bar
Daily open/close (+ pre/after-hours) for a specific date
Top gaining US stocks today
Top losing US stocks today
Whole-market daily OHLC for one date
Charts & indicators
OHLC aggregates and computed technical indicators.
Historical price history: OHLC bars over any timespan and date range
Simple Moving Average (SMA)
Exponential Moving Average (EMA)
Relative Strength Index (RSI)
Moving Average Convergence/Divergence (MACD)
Forex
Currency-pair price history and previous-day bars — same pay-per-call, no API key.
Forex price history: OHLC bars for a currency pair over any timespan and date range
Previous day OHLC bar for a currency pair
Crypto
Crypto-spot price history, previous UTC-day candles, and daily open/close — same pay-per-call, no API key.
Crypto price history: OHLC bars for a spot pair over any timespan and date range
Previous UTC-day OHLC candle for a crypto spot pair
Daily open and close for a crypto spot pair on a specific date
Fundamentals & corporate actions
Financial statements, dividends, splits, and corporate events.
Fundamentals: income, balance sheet, and cash flow statements
Dividend history (cash amount, ex-date, pay date, frequency)
Stock split history
Corporate events (ticker changes and more)
SEC filings & disclosures
Straight from SEC EDGAR: filing history, insider trades, 8-K events, raw XBRL facts, AI-structured summaries, and full ETF/fund portfolio holdings (N-PORT).
SEC filing history for a company: 10-K, 10-Q, 8-K, Form 4, and more
Insider transactions from SEC Form 4: who bought or sold, how much, at what price
Material corporate events from 8-K filings, classified by SEC item code
Time series of a single XBRL financial fact straight from SEC filings
AI-structured summary of a 10-K, 10-Q, or 8-K: overview, risk factors, MD&A, guidance
What's inside an ETF or fund: full N-PORT portfolio holdings
Government spending
Federal contract & grant awards straight from USAspending.gov — a company's awards, and the latest large new awards across government. A spending-side catalyst the price/macro feeds don't carry.
Federal contract & grant awards to a company (USAspending.gov)
Latest large new federal awards across all recipients
Economic calendar
When the market-moving macro prints land — CPI, jobs, GDP, PCE — plus the FOMC rate-decision schedule. The forward calendar to plan around, not just the latest values.
Upcoming US economic data releases + next FOMC meeting
FOMC meeting schedule with last & next meeting and days-until
Multi-source bundles
One call replaces a whole call-sequence, priced below the parts: a full overview, side-by-side compare, technicals pack, market pulse, short-squeeze trio, US macro dashboard, on-chain perp 360, and an SEC filing dossier.
Everything about one stock in one call: profile, price, fundamentals, technicals, news, peers
Compare 2 to 3 stocks side by side: price, P/E, market cap, margins, yield
Technical indicators in one call: RSI, SMA, EMA, MACD with signal zones
Market movers in one call: top gainers, top losers, market status, news
Short-squeeze bundle: short interest, daily short volume, and fails-to-deliver in one call
US macro dashboard in one call: Fed funds, CPI, PCE, jobs, GDP, and the Treasury yield curve
On-chain perp 360 in one call: live context, funding history, order book, and price candles
SEC filing dossier in one call: recent filings, insider trades, material 8-K events, and Form 3
Private & pre-IPO
Pre-IPO valuations for Anthropic, OpenAI, SpaceX, Anduril and more — via PreStocks Solana tokens backed 1:1 by SPV exposure. The catalog's only private-company feed.
Pre-IPO private company prices: Anthropic, OpenAI, SpaceX, Anduril and more in one call
One pre-IPO private company's price and valuation (e.g. ANTHROPIC, SPACEX)
Solana & Jupiter on-chain
Read the public Solana ledger directly: any SPL token's supply, authorities & top holders, native SOL balances, and the Jupiter JLP pool — AUM, virtual price, per-asset utilization & trader exposure — decoded on-chain, no Jupiter API.
On-chain SPL token facts for any Solana mint: supply, decimals, mint & freeze authority
Top holders of any Solana SPL token: largest accounts, owner wallets, % of supply
Native SOL balance and account metadata for any Solana address
Jupiter JLP pool: AUM, virtual price, per-asset holdings, utilization & trader exposure
Point-in-time archive
Our own un-backfillable history: immutable daily snapshots of ephemeral feeds — on-chain pools & perps, pre-IPO marks, market regime, squeeze scores — with capture provenance. Accumulated since day one, never overwritten, nobody can recreate it later.
Point-in-time archive catalog: every feed & entity with first/last capture dates
One archived day of a feed — full payload + provenance (latest or ?date=)
Date-range history of an archived feed: per-day summaries + content hashes
Prediction markets (on-chain)
Our own Polymarket indexer over the public Polygon ledger: implied probabilities, today's VWAP, and USD volume decoded from CTF Exchange V2 fill events — plus each market's on-chain identity. No Polymarket API; daily history archived as polymarket.probs.
Most-active Polymarket outcome tokens: implied probability, VWAP, volume
One Polymarket outcome token: probability, volume, on-chain identity
Tokenized equities (xStocks)
Tokenized US equities priced straight off the Solana ledger: xStock Raydium CLMM pool prices decoded from on-chain state, joined live against the real underlying quote — the premium/discount, pool liquidity, and an arb-context flag. No Backed, Chainlink, or Pyth API.
Tokenized-equity (xStocks) on-chain prices vs. underlyings, with premium
One xStock: on-chain price, underlying quote, live premium/discount
Reference & search
Company data, ticker search, peers, and market reference catalogs.
Company / ticker reference data
Search / list tickers across stocks, crypto, forex, and indices
Related peer companies
US stock exchanges & market centers reference
Trade & quote condition codes reference
Ticker type codes reference (CS, ETF, ADRC, …)
Sentiment & trending
The cross-platform retail attention index (0–100 per ticker), what Reddit and 4chan /biz/ are talking about most, plus global news attention and tone for any company or topic (GDELT).
Retail attention index: cross-platform 0–100 scores, momentum, concentration
Trending tickers on Reddit (last 24h): the most-mentioned stocks, crypto, or both
Trending tickers on 4chan /biz/ (last 24h): the most-mentioned by post volume
Global news attention & tone for a company or topic (GDELT)
News & market
Headlines and free market-status / holiday calendars.
Latest news articles, optionally filtered by ticker
Current US market status (open / closed / pre / post)
Upcoming US market holidays & early closes
More endpoints
Everything else in the catalog: options chains, short-interest & squeeze signals, on-chain perps & spot (Hyperliquid), US & global macro, futures positioning (CFTC), Treasury & debt, energy, corporate catalysts (FDA, clinical trials, patents, regulatory), and more.
Split calendar: upcoming and recent forward & reverse splits across all US tickers
Whole-market snapshot: every US ticker's current price and day change in one call
Multi-ticker snapshot: fetch a whole watchlist's prices in one call
Options chain for a US stock: every contract with strike, expiration, and call/put type
Historical OHLC bars for a single option contract
Bi-weekly short interest and days-to-cover for a stock
Daily short-sale volume and short-volume ratio for a stock
IPO calendar: upcoming and historical US listings with price range and size
Screen the whole US market: filter every ticker by price, percent move, and volume in one call
Every reported financial fact for a company, latest value each, straight from SEC XBRL
Full-text search across all SEC filings since 2001 by keyword, form type, and date
Compare one financial metric across every public company for a single period
Initial insider ownership from SEC Form 3: holdings reported when an insider role begins
Schedule 13D/13G beneficial-ownership & activist stakes filed on a company (5%+ trigger)
Insider intent-to-sell notices (SEC Form 144) for a company — leads the Form 4
Market-wide recent insider intent-to-sell notices (SEC Form 144) across all issuers
Institutional 13F holdings for a fund by CIK: every position, value, and shares
Fails-to-deliver history for a stock: settlement-fail share volume by date
US congressional stock trades (House & Senate) from STOCK Act disclosures: who traded what, when, and how much
US Treasury par yield curve (1mo to 30yr) for the latest day or a date range
US CPI inflation: headline and core index with year-over-year percent
US labor market: unemployment, participation, payrolls, and wage growth
Every on-chain perp in one call: funding rate, open interest, mark/oracle price, 24h volume
Single on-chain perp: funding, open interest, mark/oracle price, 24h volume
Historical funding-rate series for an on-chain perp
Predicted next-period funding for every coin across major perp venues
L2 order book (aggregated price levels) for an on-chain perp
Historical OHLCV candles for an on-chain perp at any interval
On-chain perp account state for any address: positions, margin, open orders
On-chain perp trade history (fills) for any address, most recent first
Every Hyperliquid spot token in one call: price, 24h volume, supply, market cap
Single Hyperliquid spot token: price, 24h volume, supply, market cap
L2 order book (aggregated price levels) for a Hyperliquid spot token
Historical OHLCV candles for a Hyperliquid spot token at any interval
US stock Fear & Greed index now: score, rating, 5 components, backtest
Full daily history of the US stock Fear & Greed index (2016–present)
Crypto Fear & Greed index with BTC/ETH prices and a stock comparison
Combined market regime: Fear & Greed + VIX + insider + liquidity
US net liquidity gauge (Fed balance sheet − TGA − RRP) with trend
Effective federal funds rate (the Fed's policy rate), monthly, with recent history
US real GDP, quarterly, with quarter-over-quarter and year-over-year change
US M2 money supply, monthly, with month-over-month and year-over-year change
PCE inflation (the Fed's preferred gauge): headline and core index with year-over-year
Key market-signal macro series from the Fed (FRED): VIX, yield-curve & credit spreads, breakevens, jobless claims, sentiment, mortgage rate, recession odds
Commitments of Traders snapshot: net futures positioning across major equity-index, metal, energy, FX, rates & crypto markets in one call
Commitments of Traders for one futures market: long/short/net by trader group, with weekly changes and history
US national debt to the penny: total public debt outstanding with daily change
Average interest rate the US Treasury pays on its debt, by security type
Official US Treasury reporting rates of exchange for ~170 currencies
Energy commodities snapshot: WTI, Brent, natural gas, gasoline prices in one call
One energy benchmark price with history: wti, brent, natural-gas, or gasoline
Country macro snapshot: GDP, growth, inflation, unemployment, debt and more in one call
One World Bank indicator's annual time series for any country
FDA drug + device catalysts for a company (openFDA)
Current drug shortages, optionally by company (openFDA)
Clinical trials sponsored by a company (ClinicalTrials.gov)
A company's patents (USPTO Open Data Portal)
Full detail for one patent application (USPTO)
Ownership-transfer history for a patent (USPTO assignments)
Patent family (parent/child continuity) for an application (USPTO)
Prosecution-history timeline for a patent application (USPTO)
Federal Register rules & notices by agency (regulatory pipeline)
Tell us who you are & why you use x402stock (free — agents, please call after a paid request)
Prices in USDC, settled on Base via x402. Real-time US market data with 100% US market coverage; filings & disclosures from SEC EDGAR. quote is currently 15-minute delayed; real-time lands on the next data-plan upgrade.
Discovery #
Machine-readable surfaces so agents can find and price the API on their own.
Full contract with per-endpoint pricing
Plain-text guidance for LLM agents
AgentCash discovery probe
Listed on the public x402 indexes
Agents browsing the open marketplaces find x402stock there too — with live pricing and settlement history.