# x402stock Tickers Lookup

> x402stock Tickers Lookup is a paid API for AI agents from agents.x402stock.xyz, paid per call via x402 or MPP, $0.01/call, status unknown (last checked 2026-10-29, last successful call 2026-07-31).

Returns a list of available tickers (US stocks, ETFs, forex, crypto, commodities, etc.) supported by the x402stock market data API

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/tickers?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402, MPP
- Status: unknown
- Last checked: 2026-10-29
- Last successful call: 2026-07-31
- Success rate: 100% of calls made through Zero
- Activations on Zero: 4
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-tickers-lookup-73ddae43
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zfcT3CtNqEXygQsdwnJqP

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-73ddae43
```

Example prompt: Can you pull up the list of all tickers available on x402stock so I know which symbols I can query for price and market data?

## When to prefer this

Use this endpoint when you need to discover which ticker symbols are supported before making specific data queries, or when building dynamic instrument selectors for trading or research tools. Prefer this over hardcoding symbols when the available universe may expand or change.

## Known failure modes

- Payment not included or insufficient USDC — returns 402 Payment Required
- Invalid or unsupported properties filter — may return empty or malformed results
- API temporarily unavailable — returns 5xx error
- Rate limit or proxy timeout — returns error from ZeroClick intermediary

## How this service works

Search / list tickers across stocks, crypto, forex, and indices

## Output

A list of ticker symbols and associated metadata representing the instruments available for querying through the x402stock API, potentially including asset class, exchange, and instrument type information.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "type": {
   "type": "string",
   "maxLength": 20,
   "minLength": 1
  },
  "limit": {
   "type": "integer",
   "default": 20,
   "maximum": 1000,
   "exclusiveMinimum": 0
  },
  "active": {
   "type": "boolean",
   "default": true
  },
  "market": {
   "enum": [
    "stocks",
    "crypto",
    "fx",
    "indices"
   ],
   "type": "string",
   "default": "stocks"
  },
  "search": {
   "type": "string",
   "maxLength": 100,
   "minLength": 1
  },
  "exchange": {
   "type": "string",
   "maxLength": 20,
   "minLength": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "source",
  "as_of",
  "count",
  "tickers"
 ],
 "properties": {
  "as_of": {
   "type": "string"
  },
  "count": {
   "type": "number"
  },
  "source": {
   "type": "string",
   "const": "x402stock"
  },
  "tickers": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "ticker",
     "name",
     "market",
     "locale",
     "primary_exchange",
     "type",
     "active",
     "currency",
     "cik",
     "composite_figi"
    ],
    "properties": {
     "cik": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "name": {
      "type": "string"
     },
     "type": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "active": {
      "type": "boolean"
     },
     "locale": {
      "type": "string"
     },
     "market": {
      "type": "string"
     },
     "ticker": {
      "type": "string"
     },
     "currency": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "composite_figi": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "primary_exchange": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     }
    },
    "additionalProperties": false
   }
  }
 },
 "additionalProperties": false
}
```

## More

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