{"uid":"cap_6Ituj1BRizW3yM0m-7cYV","slug":"tradeos-ticker-search-702b947e","name":"TradeOS Ticker Search","description":"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:.","url":"https://ai.tradeos.xyz/api/x402/search_tickers?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_U_Z-6xlBN82W-N6TVEqP_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Resolve ticker before price lookup","prompt":"I want to get the latest price for Tesla — can you search for its ticker symbol first so we can pull the market snapshot?"},{"title":"Find forex pair ticker with prefix","prompt":"Look up the EUR/USD currency pair ticker for me — I know forex pairs need a special prefix like C: on TradeOS."},{"title":"Discover exchange listing for ETF","prompt":"Search for SPY and tell me which exchange it trades on and whether the market is currently open."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-19T23:36:05.569Z","isFirstParty":false,"canonicalSlug":"tradeos-ticker-search-702b947e"}