# x402stock Ticker Types Lookup

> x402stock Ticker Types 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 all supported US stock ticker types (e.g. Common Stock, ETF) with their codes, asset classes, and descriptions

## Facts

- Endpoint: GET https://x402stock.vercel.app/api/v1/ticker-types?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-ticker-types-lookup-ee65f2eb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_53YKKTv2ejnHZhXQJpKnJ

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-types-lookup-ee65f2eb
```

Example prompt: What types of US stock securities are supported — like common stocks and ETFs — and what are their official codes I can use to filter other stock queries?

## When to prefer this

Use this endpoint when you need to discover or validate the universe of ticker type codes before querying other x402stock endpoints (e.g. to filter by security type). It is the canonical reference for US stock asset classifications in the x402stock API and requires no additional parameters. Prefer this over hardcoding type codes.

## Known failure modes

- Payment required (402): USDC payment of $0.01 not provided or invalid — agent must attach x402 payment header
- Empty result set: no ticker types match the optional filter parameter
- Service unavailable: upstream data provider ('massive') is down or returning stale data
- Malformed request: invalid properties filter string causes 400 error

## 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 an as_of timestamp, a count of available types, and an array of ticker type objects each with a code (e.g. 'CS', 'ETF'), locale ('us'), asset_class ('stocks'), and a human-readable description. Sourced from the 'massive' data provider.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-05-29T20:00:00.000Z",
  "count": 2,
  "types": [
   {
    "code": "CS",
    "locale": "us",
    "asset_class": "stocks",
    "description": "Common Stock"
   },
   {
    "code": "ETF",
    "locale": "us",
    "asset_class": "stocks",
    "description": "Exchange Traded Fund"
   }
  ],
  "source": "massive"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-ticker-types-lookup-ee65f2eb/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)