# x402stock Ticker Report Endpoint

> x402stock Ticker Report Endpoint is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.5/call, status unknown (last checked 2026-10-11).

Returns a comprehensive market data report for a given stock ticker, including price, fundamentals, technicals, and recent news.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/report/%7Bticker%7D?utm_source=zero.xyz
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-ticker-report-endpoint-4c9ed062
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kmU55MiIdajYm_44a76uC

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-ticker-report-endpoint-4c9ed062
```

Example prompt: Pull a full market report for AAPL — I want the current price, fundamentals like P/E and EPS, technical indicators like RSI and moving averages, and any recent news headlines.

## When to prefer this

Use this endpoint when an AI agent needs a single-call comprehensive snapshot of a US stock or ETF including price, fundamentals, technicals, and news — without needing to manage API keys or subscriptions. Ideal for pay-per-use workflows where the agent only occasionally needs market data, or when integrating financial data into an autonomous agent pipeline using the x402 micropayment protocol on Base.

## Known failure modes

- Invalid or unrecognized ticker symbol returns an error
- Payment of 0.5 USDC via x402 on Base not completed results in 402 Payment Required
- Network or upstream data provider outage returns 5xx error
- Ticker exists but has no data for certain sections (indicated by section status flags other than 'ok')
- Expired or stale artifact URL if cached response is used after expiry

## 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 containing the ticker symbol, company name, current price with change and percent change, fundamental stats (EPS, P/E ratio, market cap, 52-week range, margins, dividend yield), technical indicators (RSI-14, EMA-20, SMA-50), recent news articles with titles and URLs, section availability flags, an as-of timestamp, and a PNG chart artifact URL with expiry.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "name": "Apple Inc.",
   "news": [
    {
     "url": "https://example.com/a",
     "title": "Apple unveils new chips at WWDC",
     "publisher": "Reuters"
    }
   ],
   "price": {
    "last": 214.29,
    "change": 1.86,
    "change_percent": 0.88
   },
   "stats": {
    "eps": 6.47,
    "pe_ratio": 33.1,
    "market_cap": 3290000000000,
    "week52_low": 164.08,
    "week52_high": 237.49,
    "net_margin_percent": 25.3,
    "gross_margin_percent": 46.2,
    "dividend_yield_percent": 0.47
   },
   "sections": {
    "news": "ok",
    "price": "ok",
    "profile": "ok",
    "technicals": "ok",
    "fundamentals": "ok"
   },
   "technicals": {
    "ema_20": 211.4,
    "rsi_14": 54.2,
    "sma_50": 207.8
   }
  },
  "as_of": "2026-06-19T15:00:00.000Z",
  "source": "x402stock",
  "ticker": "AAPL",
  "artifact": {
   "id": "9f1c2a7b4e8d40b1a2c3d4e5f6071829",
   "url": "https://x402stock.xyz/artifacts/9f1c2a7b4e8d40b1a2c3d4e5f6071829.png",
   "format": "png",
   "expires_at": "2026-07-19T15:00:00.000Z"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-ticker-report-endpoint-4c9ed062/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)