The top x402 API for
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.
Prefer a key over per-call billing? One plan, $99/mo, unlimited calls to every endpoint.
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.
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.
# 1 · set up your agent's wallet
npx agentcash onboard
# 2 · free call — works with zero balance
npx agentcash fetch https://x402stock.xyz/api/v1/market-status
# 3 · fund the wallet (prints a USDC deposit link)
npx agentcash accounts
# 4 · pay $0.01 for the last price of AAPL
npx agentcash fetch https://x402stock.xyz/api/v1/quote/AAPL
# 5 · save the service so your agent reuses it
npx agentcash add https://x402stock.xyzPlug it into Claude Code
Prefer a flat rate? One command connects the entire catalog to Claude Code — or Cursor, Claude Desktop, and any MCP client. Our MCP server exposes four tools that let Claude search these 136 endpoints and fetch the right data itself, every call covered by your All-Access subscription.
# 1 · subscribe once — your sk_live_… key is shown at checkout
open https://x402stock.xyz/pricing
# 2 · connect the MCP server (one command)
claude mcp add --transport http x402stock https://x402stock.xyz/api/mcp \
--header "Authorization: Bearer sk_live_YOUR_KEY"
# 3 · ask for anything — live data, no copy-pasting tickers into browsers
claude "Compare NVDA vs AMD fundamentals, then pull insider trades for both"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.
New endpoints ship constantly
Get a short note when new data lands — no marketing, unsubscribe anytime.