Pay-per-call over x402 · USDC on Base

The top x402 API for
US stock market data.

Prices, fundamentals, SEC filings, news, and technical indicators across every US ticker — built for AI agents. No API keys, no accounts. Your agent pays a few cents per request in USDC and gets clean JSON back.

59
endpoints
$0.01
starting price
0
API keys
100%
US market coverage

Call it from any x402-aware agent

Claude Code
Cursor
Codex
AgentCash
Coinbase AgentKit
x402-fetch

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 59 endpoints →
01$0.05

Stock Overview

Profile, price, fundamentals, technicals, news & peers for one ticker — in a single call.

GET /api/v1/overview/{ticker}
02$0.03

AI Filing Summary

10-K / 10-Q / 8-K distilled to overview, risks, MD&A, and guidance as structured JSON.

GET /api/v1/filing-summary/{ticker}
03$0.05

Compare Stocks

2–3 tickers side by side: price, P/E, market cap, margins, and yield.

GET /api/v1/compare
04$0.03

Insider Trades

Form 4 buys & sells with role, size, price, and a net-buying signal.

GET /api/v1/insider-trades/{ticker}
05$0.03

Technicals Pack

RSI, SMA, EMA, and MACD with signal zones in one momentum read.

GET /api/v1/technicals/{ticker}
06$0.03

Market Pulse

Top gainers, top losers, session status, and headlines — no ticker needed.

GET /api/v1/market-pulse

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.

Gasless USDC settlement No signup or keys Free starter credit
agent · terminal
# 1 · onboard your agent (free starter credit)
npx agentcash onboard

# 2 · free call for current market status
npx agentcash call https://x402stock.xyz/api/v1/market-status

# 3 · pay $0.01 for the last price of AAPL
npx agentcash call https://x402stock.xyz/api/v1/quote/AAPL

# 4 · save the service so your agent reuses it
npx agentcash save 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.

18 live
Suggestions
  • ›_

    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
  • ›_

    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
18 of 18 capabilitiespay-per-call · settled in USDC

Wire it in once with npx agentcash save 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.

  1. 01
    Request

    Agent calls an endpoint with no payment header.

  2. 02
    402 challenge

    Server replies HTTP 402 with the asset, amount, and payTo.

  3. 03
    Sign & retry

    Wallet signs a gasless USDC transfer and retries the request.

  4. 04
    Settle & serve

    Facilitator settles on Base; the handler returns JSON.

Full catalog

57 paid endpoints from $0.01, plus free market status. Every response is shaped { ticker, data, source, as_of }.

openapi.json →

Prices & snapshots

Last price, full snapshots, daily bars, and the day's movers.

GET/api/v1/quote/{ticker}

Last price for a US stock, 15 minute delayed

$0.01
GET/api/v1/snapshot/{ticker}

Full ticker snapshot (last quote, last trade, OHLC, prev close, %change)

$0.01
GET/api/v1/prev-close/{ticker}

Previous trading day OHLC bar

$0.01
GET/api/v1/open-close/{ticker}

Daily open/close (+ pre/after-hours) for a specific date

$0.01
GET/api/v1/gainers

Top gaining US stocks today

$0.02
GET/api/v1/losers

Top losing US stocks today

$0.02
GET/api/v1/grouped-daily

Whole-market daily OHLC for one date

$0.02

Charts & indicators

OHLC aggregates and computed technical indicators.

GET/api/v1/aggregates/{ticker}

Historical price history: OHLC bars over any timespan and date range

$0.02
GET/api/v1/indicators/sma/{ticker}

Simple Moving Average (SMA)

$0.01
GET/api/v1/indicators/ema/{ticker}

Exponential Moving Average (EMA)

$0.01
GET/api/v1/indicators/rsi/{ticker}

Relative Strength Index (RSI)

$0.01
GET/api/v1/indicators/macd/{ticker}

Moving Average Convergence/Divergence (MACD)

$0.01

Forex

Currency-pair price history and previous-day bars — same pay-per-call, no API key.

GET/api/v1/forex/{pair}/aggregates

Forex price history: OHLC bars for a currency pair over any timespan and date range

$0.02
GET/api/v1/forex/{pair}/prev-close

Previous day OHLC bar for a currency pair

$0.01

Crypto

Crypto-spot price history, previous UTC-day candles, and daily open/close — same pay-per-call, no API key.

GET/api/v1/crypto/{pair}/aggregates

Crypto price history: OHLC bars for a spot pair over any timespan and date range

$0.02
GET/api/v1/crypto/{pair}/prev-close

Previous UTC-day OHLC candle for a crypto spot pair

$0.01
GET/api/v1/crypto/{pair}/open-close

Daily open and close for a crypto spot pair on a specific date

$0.01

Fundamentals & corporate actions

Financial statements, dividends, splits, and corporate events.

GET/api/v1/financials/{ticker}

Fundamentals: income, balance sheet, and cash flow statements

$0.02
GET/api/v1/dividends/{ticker}

Dividend history (cash amount, ex-date, pay date, frequency)

$0.01
GET/api/v1/splits/{ticker}

Stock split history

$0.01
GET/api/v1/events/{ticker}

Corporate events (ticker changes and more)

$0.01

SEC filings & disclosures

Straight from SEC EDGAR: filing history, insider trades, 8-K events, raw XBRL facts, and AI-structured summaries.

GET/api/v1/filings/{ticker}

SEC filing history for a company: 10-K, 10-Q, 8-K, Form 4, and more

$0.01
GET/api/v1/insider-trades/{ticker}

Insider transactions from SEC Form 4: who bought or sold, how much, at what price

$0.03
GET/api/v1/material-events/{ticker}

Material corporate events from 8-K filings, classified by SEC item code

$0.03
GET/api/v1/concept/{ticker}

Time series of a single XBRL financial fact straight from SEC filings

$0.02
GET/api/v1/filing-summary/{ticker}

AI-structured summary of a 10-K, 10-Q, or 8-K: overview, risk factors, MD&A, guidance

$0.03

Multi-source bundles

One call, many sources: a full overview, a side-by-side compare, a technicals pack, and a market pulse.

GET/api/v1/overview/{ticker}

Everything about one stock in one call: profile, price, fundamentals, technicals, news, peers

$0.05
GET/api/v1/compare

Compare 2 to 3 stocks side by side: price, P/E, market cap, margins, yield

$0.05
GET/api/v1/technicals/{ticker}

Technical indicators in one call: RSI, SMA, EMA, MACD with signal zones

$0.03
GET/api/v1/market-pulse

Market movers in one call: top gainers, top losers, market status, news

$0.03

Reference & search

Company data, ticker search, peers, and market reference catalogs.

GET/api/v1/ticker/{ticker}

Company / ticker reference data

$0.01
GET/api/v1/tickers

Search / list tickers across stocks, crypto, forex, and indices

$0.01
GET/api/v1/related/{ticker}

Related peer companies

$0.01
GET/api/v1/exchanges

US stock exchanges & market centers reference

$0.01
GET/api/v1/conditions

Trade & quote condition codes reference

$0.01
GET/api/v1/ticker-types

Ticker type codes reference (CS, ETF, ADRC, …)

$0.01

Social trending

What stocks and crypto Reddit and 4chan /biz/ are talking about most over the last 24 hours.

GET/api/v1/trending/reddit

Trending tickers on Reddit (last 24h): the most-mentioned stocks, crypto, or both

$0.01
GET/api/v1/trending/4chan

Trending tickers on 4chan /biz/ (last 24h): the most-mentioned by post volume

$0.01

News & market

Headlines and free market-status / holiday calendars.

GET/api/v1/news

Latest news articles, optionally filtered by ticker

$0.02
GET/api/v1/market-status

Current US market status (open / closed / pre / post)

free
GET/api/v1/market-holidays

Upcoming US market holidays & early closes

free

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.

Listed on the public x402 indexes

Agents browsing the open marketplaces find x402stock there too — with live pricing and settlement history.