Search securities

Use this route when a workflow starts with a company name or partial keyword and needs candidate symbols. q is required and results are matches, not a final identity decision. Resolve the selected symbol or CIK before using it for issuer-scoped research, especially when names are similar or a company has multiple listed classes. The route is subject to the configured result limit and can return a source or service error instead of an empty successful list. See entity resolution and API conventions.

get/v1/market/search

Request

  • Base URL: https://api.turos.app
  • URL: https://api.turos.app/v1/market/search
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Query parameters

qstring required

Company name, ticker fragment, or keyword used to find candidate securities.

limitinteger

Maximum candidate records to return. Defaults to 15; values above 50 are capped.

Response

Candidate securities with the redacted market-data source label and request tracing metadata.

object'market_search' required
sourcestring required

Customer-safe market-data source label.

sourceUrlstring uri required

Customer-safe source documentation URL; vendor transport URLs are redacted.

resultsobject[] required

Provider search candidates after vendor envelope and URL redaction.

requestIdstring required
traceparentstring required

Changes

No recorded changes to this operation across all 1 revision of this API.