stocks_search_tickers

Resolve a company name/ticker/fragment to ranked candidate entities.

The result is the shared envelope: data.query echoes the search and data.matches is the ranked list (best first); meta holds source and the freshest match as_of; pagination is null — this is a bounded relevance list, not a paged one, so refine the query for better matches rather than expecting to page.

Each match carries cik, name, symbol (the matched or representative active ticker, or null if the company has no active symbol), exchange, symbol_active, a score in [0, 1], and a match_reason (ticker_exact, ticker_prefix, name_exact, name_fuzzy) so you can see why a candidate ranked where it did. An empty/whitespace query returns no matches (a normal, empty success — not an error).

Use this to disambiguate before calling a data tool; once you have a cik or exact ticker, call stocks_get_company_facts for the profile or a statement/price tool for the data.