# TradeOS Ticker Search

> TradeOS Ticker Search is a paid API for AI agents from ai.tradeos.xyz, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-19).

Search financial instruments by name or ticker symbol, returning matching tickers, full names, exchanges, and market-open status across stocks, ETFs, forex, metals, and crypto.

## Facts

- Endpoint: POST https://ai.tradeos.xyz/api/x402/search_tickers?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tradeos-ticker-search-702b947e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6Ituj1BRizW3yM0m-7cYV

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 tradeos-ticker-search-702b947e -d '<json body>'
```

Example prompt: Can you search TradeOS for the ticker symbol for Ethereum in USD so I can pull up its latest market data? I think it might be on the crypto exchange.

## When to prefer this

Use this endpoint first when you have a partial name or uncertain ticker symbol and need to resolve it to the canonical ticker, exchange, and open status before calling get_market_snapshot, get_market_candles, or get_market_technical_analysis. Prefer this over guessing ticker formats, especially for forex (C: prefix), metals (C: prefix), and crypto (X: prefix).

## Known failure modes

- No matches found for an obscure or misspelled instrument name
- Missing required C: or X: prefix causes ticker not found in downstream calls
- Query too short or too broad returns irrelevant results
- Exchange filter mismatch excludes the target instrument
- Rate limit or payment failure returns 402 or 429 status
- Crypto or FX instruments not found when searched without proper prefix context

## How this service works

Search market instruments by name or ticker. Returns matching tickers, names, exchanges and market-open status. Use the returned ticker with get_market_snapshot for the latest market data, get_market_candles for OHLCV history, or get_market_technical_analysis for written chart analysis. Popular examples include AAPL, SPY, gold XAUUSD (C:XAUUSD), EURUSD (C:EURUSD), BTCUSD (X:BTCUSD), and ETHUSD (X:ETHUSD). FX/metals require C:; crypto requires X:.

## Output

A list of up to the requested number of matching instruments, each containing the ticker symbol (formatted with C: for FX/metals or X: for crypto where applicable), the full instrument name, the exchange it trades on, and a flag indicating whether the market is currently open.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 5,
   "maximum": 50,
   "minimum": 1
  },
  "query": {
   "type": "string",
   "maxLength": 200,
   "minLength": 1,
   "description": "Instrument name or ticker"
  },
  "exchange": {
   "enum": [
    "NASDAQ",
    "NYSE",
    "CRYPTO",
    "NYSE Arca",
    "NYSE American"
   ],
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tradeos-ticker-search-702b947e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ai.tradeos.xyz](https://www.zero.xyz/host/ai.tradeos.xyz/llms.txt)
