---
title: "Search securities"
method: GET
path: "/v1/market/search"
---

# Search securities

`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

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](https://docs.secapi.ai/api-reference/entities/get-v1-entities-resolve) and [API conventions](https://docs.secapi.ai/api-conventions).

## Query parameters

- `q` string, required
- `limit` integer

## Response `200`

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

- MarketSearch
  - `object` 'market_search', required
  - `source` string, required: Customer-safe market-data source label.
  - `sourceUrl` string, uri, required: Customer-safe source documentation URL; vendor transport URLs are redacted.
  - `results` object[], required: Provider search candidates after vendor envelope and URL redaction.
  - `requestId` string, required
  - `traceparent` string, required

## Other responses

- `default`: Contract-aware error response

---

[API](https://skmtc.dev/turos/apis/turos-api.md) · [All operations](https://skmtc.dev/turos/apis/turos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/turos/apis/turos-api/revisions/a68d3ec80a56?raw)