Pay-per-call over x402 · USDC on Base

US stock market data,
priced for agents.

Prices, fundamentals, news, corporate actions, and technical indicators across every US ticker. No API keys. No accounts. Your agent pays a few cents per request in USDC — and gets clean JSON back.

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 — current market status
npx agentcash call https://x402stock.xyz/api/v1/market-status

# 3 · pay $0.01 — last price for 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

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.

Endpoints

23 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's 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.03

Charts & indicators

OHLC aggregates and computed technical indicators.

GET/api/v1/aggregates/{ticker}

OHLC aggregate bars (any timespan, any range)

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

Simple Moving Average (SMA)

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

Exponential Moving Average (EMA)

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

Relative Strength Index (RSI)

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

Moving Average Convergence/Divergence (MACD)

$0.02

Fundamentals & corporate actions

Financial statements, dividends, splits, and corporate events.

GET/api/v1/financials/{ticker}

Fundamentals — income, balance sheet & cash-flow statements

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

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

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

Stock split history

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

Corporate events (ticker changes, etc.)

$0.01

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 US-listed tickers

$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

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. Data sourced from Massive with 100% US market coverage. 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.