# x402stock.xyz Ticker Types Reference

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

Returns a reference list of security type codes (e.g. CS, ETF, PFD, WARRANT) with their descriptions, asset classes, and locale used in ticker reference data.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/ticker-types
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-xyz-2e0f085b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_riPSA0z77eIMmJYw2wJnD

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-xyz-2e0f085b
```

Example prompt: What are all the valid security type codes and their descriptions I can use when filtering US stock tickers — things like CS for common stock, ETF, PFD, WARRANT, etc.?

## When to prefer this

Use this endpoint when you need to enumerate or validate the complete set of security type codes before filtering a ticker search, building a UI dropdown, or decoding the 'type' field returned by ticker lookup endpoints. It requires no query parameters and is a simple static reference lookup.

## Known failure modes

- 402 Payment Required if USDC payment header is missing or invalid
- Network timeout if the upstream data provider is unavailable
- Empty or stale as_of date if reference data has not been refreshed recently

## How this service works

Reference list of security type codes used in ticker reference data (e.g. CS = Common Stock, ETF, PFD, WARRANT) with descriptions. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.

## Output

A JSON object containing a source identifier, an as_of date, a count of types, and an array of type objects each with a code (e.g. 'CS'), a human-readable description (e.g. 'Common Stock'), an asset_class, and a locale.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {}
 }
}
```

## 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": "x402stock"
 }
}
```

## More

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