---
title: "Symbol search"
method: GET
path: "/symbol_search"
tags: ["reference_data"]
---

# Symbol search

`GET /symbol_search`

The symbol search endpoint allows users to find financial instruments by name or symbol. It returns a list of matching symbols, ordered by relevance, with the most relevant instrument first. This is useful for quickly locating specific stocks, ETFs, or other financial instruments when only partial information is available.

## Query parameters

- `symbol` string, required
- `outputsize` integer
- `show_plan` boolean

## Response `200`

- object
  - `data` SymbolSearchResponseItem[], required — List of symbols matching the search criteria
    - `symbol` string, required — Ticker symbol of instrument
    - `instrument_name` string, required — Name of exchange
    - `exchange` string, required — Exchange where instrument is traded
    - `mic_code` string, required — Market identifier code (MIC) under ISO 10383 standard
    - `exchange_timezone` string, required — Time zone where exchange is located
    - `instrument_type` string, required — Type of instrument
    - `country` string, required — Country to which stock exchange belongs to
    - `currency` string, required — Currency in which the instrument is traded
    - `access` SymbolSearchResponseItemAccess — Info on which plan symbol is available (displayed then `show_plan` is `true`)
      - `global` string, required — Level of access to the symbol
      - `plan` string, required — The individual plan name for the symbol
      - `plan_business` string, required — The business plan name for the symbol
  - `status` string, required — Status of the response

## Other responses

- `400`
- `401`
- `403`
- `404`
- `414`
- `429`
- `500`

---

[API](https://skmtc.net/twelvedata/apis/twelve-data-api.md) · [All operations](https://skmtc.net/twelvedata/apis/twelve-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twelvedata/twelve-data-api/revisions/c4a12725cdb5/schema)