API Reference

Search for underlying ticker symbols.

Endpoint

GET /v1/tickers/search

Example Request

curl \
  "https://api.cutemarkets.com/v1/tickers/search/?query=NFLX&limit=8" \
  -H "Authorization: Bearer YOUR_API_KEY"

Sample Response

{
  "status": "OK",
  "request_id": "cm_7546c8d1ad144068910f4fbf30a01e4f",
  "results": [
    {
      "symbol": "NFLX",
      "name": "NetFlix Inc"
    }
  ]
}

Search behavior

Ticker search is a discovery endpoint, not a market-data endpoint. Use it when a user types a partial company name or symbol and your UI needs a short list of candidate underlyings. After the user selects a symbol, move to the relevant product endpoint: stock reference for company metadata, stock snapshots for current stock state, or options expirations before requesting an option chain.

UI guidance

Keep ticker search results small and explicit. Display symbol and name, then let the selected route determine whether the app needs stocks or options data. Do not treat search results as proof that options exist for a ticker; fetch listed expirations first when the next action is an options chain, options contract list, or expiration-specific scanner.

Autocomplete implementation notes

Ticker search works best as a lightweight autocomplete step. Debounce user input, request a small limit, and show the raw symbol in a monospace style so it is easy to distinguish from the company name. If the user types a symbol-like query, rank exact symbol matches above broader name matches. If the user types a company name fragment, keep the displayed result compact and let the detail endpoint provide richer metadata after selection.

Do not join ticker search directly to a chain request without a selection step. Search results can include symbols that are valid stocks but do not have the options coverage your workflow expects. The safer options sequence is search, select underlying, fetch listed expirations, then request contracts or a chain for one selected date.

Validation and caching

Search results are good candidates for short-lived client caching because users often type, delete, and retype the same prefixes. Cache the query string, result list, and timestamp, but do not cache forever. Ticker status, names, and related metadata can change after corporate actions, listings, delistings, or symbol changes.

For server-side applications, store the selected symbol separately from the displayed company name. The symbol is the routing key for downstream API calls; the name is presentation metadata. If a user reports that the wrong company appeared, the symbol and request id are the fields that make the issue debuggable.

Common mistakes

• Treating a search hit as proof that listed options exist.
• Showing only company names and hiding the exact symbol.
• Requesting a full option chain on every keystroke.
• Reusing a Stocks API key for options endpoints after selection.
• Caching search results so long that renamed or inactive tickers remain visible.