# x402stock Stock Overview API

> x402stock Stock Overview API is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Returns a comprehensive overview for a US stock ticker including price, profile, fundamentals, technicals, dividends, peers, news, and corporate actions — paid per-call in USDC via x402.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/overview/%7Bticker%7D
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-stock-overview-api-e206236e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1glK8BiCG51JUlWD0PvhB

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402stock-stock-overview-api-e206236e
```

Example prompt: Pull up a full overview for AAPL — I want the current price, P/E ratio, RSI, dividend yield, and a list of peer companies.

## When to prefer this

Use this endpoint when you need a single comprehensive call covering price, fundamentals, technicals, dividends, peers, and news for a US-listed stock — ideal for AI agents that need a full financial snapshot without managing API keys or subscriptions, paying only $0.05 USDC per call via x402 on Base.

## Known failure modes

- Invalid or unknown ticker symbol returns an error or empty data
- Ticker for a non-US or delisted security may return partial or no data
- Payment failure via x402 (insufficient USDC balance or network issue) blocks the request
- Rate limiting or facilitator downtime may result in 402 or 5xx errors
- Some data sections may be unavailable for certain tickers (e.g., no dividends for non-dividend stocks), reflected in the sections status map

## How this service works

Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.

## Output

A JSON object with multiple sections for the requested ticker: real-time (15-min delayed) price data (OHLCV, change, vwap, previous close), company profile (name, sector, exchange, market cap, employees, SIC code, list date, description), fundamental metrics (EPS, revenue, net income, gross/net margins, P/E, fiscal period), technical indicators (RSI-14, MACD, EMA-20, SMA-50 with positions relative to price), dividend info (yield, annualized amount, last payment, frequency), recent news headlines with URLs and publishers, peer ticker symbols, corporate actions and stock splits, and a section-status map indicating which data types are available.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "news": [
   {
    "url": "https://example.com/news/apple-high",
    "title": "Apple reaches new all-time high",
    "tickers": [
     "AAPL"
    ],
    "publisher": "Example Wire",
    "published_at": "2026-05-29T12:00:00Z"
   }
  ],
  "as_of": "2026-05-30T07:00:00.000Z",
  "peers": [
   "MSFT",
   "AMZN",
   "GOOGL",
   "NVDA",
   "META"
  ],
  "price": {
   "day": {
    "low": 309.53,
    "high": 315,
    "open": 311.775,
    "vwap": 311.9766,
    "close": 312.06,
    "volume": 70030122
   },
   "last": 311.35,
   "change": -1.16,
   "timestamp": "2026-05-29T20:00:00.000Z",
   "delayed_by": "15 minutes",
   "is_delayed": true,
   "change_percent": -0.371,
   "previous_close": 312.51
  },
  "source": "x402stock",
  "ticker": "AAPL",
  "profile": {
   "name": "Apple Inc.",
   "type": "CS",
   "sector": "ELECTRONIC COMPUTERS",
   "exchange": "XNAS",
   "homepage": "https://www.apple.com",
   "logo_url": "https://api.massive.com/v1/reference/company-branding/example/logo.svg",
   "sic_code": "3571",
   "employees": 166000,
   "list_date": "1980-12-12",
   "market_cap": 4589945623560,
   "description": "Apple designs and sells consumer electronics, software, and services.",
   "shares_outstanding": 14687356000
  },
  "sections": {
   "news": "ok",
   "peers": "ok",
   "price": "ok",
   "profile": "ok",
   "dividends": "ok",
   "technicals": "ok",
   "fundamentals": "ok",
   "corporate_actions": "ok"
  },
  "dividends": {
   "last": {
    "pay_date": "2026-05-14",
    "cash_amount": 0.27,
    "ex_dividend_date": "2026-05-11"
   },
   "count": 8,
   "frequency": 4,
   "yield_percent": 0.35,
   "annualized_amount": 1.08
  },
  "technicals": {
   "macd": {
    "value": 10.39,
    "signal": 9.78,
    "position": "above_signal",
    "histogram": 0.61
   },
   "ema_20": {
    "value": 283.23,
    "position": "above",
    "price_vs_percent": 9.92
   },
   "rsi_14": {
    "zone": "overbought",
    "value": 78.77
   },
   "sma_50": {
    "value": 275.28,
    "position": "above",
    "price_vs_percent": 13.11
   }
  },
  "fundamentals": {
   "eps": 8.26,
   "period": "ttm",
   "revenue": 451442000000,
   "end_date": "2026-03-28",
   "pe_ratio": 37.69,
   "net_income": 122575000000,
   "fiscal_year": null,
   "gross_profit": 216071000000,
   "fiscal_period": "TTM",
   "net_margin_percent": 27.15,
   "gross_margin_percent": 47.86
  },
  "corporate_actions": {
   "events": [
    {
     "date": "2003-09-10",
     "type": "ticker_change",

… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-stock-overview-api-e206236e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)