# x402stock Tickers Lookup

> x402stock Tickers Lookup is a paid API for AI agents from x402stock.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Returns a list of US-listed stock tickers with metadata including name, type, exchange, FIGI, and active status

## Facts

- Endpoint: GET https://x402stock.vercel.app/api/v1/tickers?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-tickers-lookup-6d8ab642
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hisXlTEPFRu64m_AmY0j0

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-tickers-lookup-6d8ab642
```

Example prompt: Can you look up the ticker metadata for Apple — I want to know its official ticker symbol, which exchange it trades on, its Composite FIGI, and whether it's currently active?

## When to prefer this

Use this endpoint when you need to resolve a company name to a ticker symbol, verify ticker metadata (exchange, FIGI, CIK, active status), or enumerate US-listed equities. Prefer this over price endpoints when you only need instrument identification, not pricing data. Best for enriching a known company name with structured financial identifiers.

## Known failure modes

- Ticker not found returns empty tickers array with count 0
- Payment not provided or rejected results in 402 Payment Required response
- Invalid query parameters return 400 Bad Request
- Stale data if market is closed — as_of reflects last market close
- Rate limiting if payment gateway is congested

## How this service works

US stock prices, snapshots, OHLC bars, fundamentals, corporate actions, technical indicators and news for AI agents. No API keys. No accounts. Pay per request in USDC via x402.

## Output

A JSON object containing a list of ticker records, each with fields: ticker symbol, company name, CIK, stock type (e.g. CS for common stock), active status, locale (us), market (stocks), currency (usd), composite FIGI, and primary exchange. Also includes a count, source, and as_of timestamp.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-05-29T20:00:00.000Z",
  "count": 1,
  "source": "massive",
  "tickers": [
   {
    "cik": "0000320193",
    "name": "Apple Inc.",
    "type": "CS",
    "active": true,
    "locale": "us",
    "market": "stocks",
    "ticker": "AAPL",
    "currency": "usd",
    "composite_figi": "BBG000B9XRY4",
    "primary_exchange": "XNAS"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-tickers-lookup-6d8ab642/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.vercel.app](https://www.zero.xyz/host/x402stock.vercel.app/llms.txt)