# Stocks

The stocks endpoint provides a daily updated list of all available stock symbols. It returns an array containing the symbols, which can be used to identify and access specific stock data across various services. This endpoint is essential for users needing to retrieve the latest stock symbol information for further data requests or integration into financial applications.

**API credits cost:** `1` per request

## Parameters

- `symbol` (string, optional)
  The ticker symbol of an instrument for which data is requested


- `figi` (string, optional)
  Filter by financial instrument global identifier (FIGI). This request parameter is available starting with the Ultra plan


- `isin` (string, optional)
  Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section


- `cusip` (string, optional)
  The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section


- `cik` (string, optional)
  The CIK of an instrument for which data is requested


- `exchange` (string, optional)
  Filter by exchange name


- `mic_code` (string, optional)
  Filter by market identifier code (MIC) under ISO 10383 standard


- `country` (string, optional)
  Filter by country name or alpha code, e.g., `United States` or `US`


- `type` (string, optional)
  The asset class to which the instrument belongs


- `format` (string, optional)
  The format of the response data


- `delimiter` (string, optional)
  The separator used in the CSV response data


- `show_plan` (boolean, optional)
  Adds info on which plan symbol is available


- `include_delisted` (boolean, optional)
  Include delisted identifiers



## Response

- `data` (array of object)
  List of stock instruments
  - `symbol` (string)
    Instrument symbol (ticker)
  - `name` (string)
    Full name of instrument
  - `currency` (string)
    Currency of the instrument according to the ISO 4217 standard
  - `exchange` (string)
    Exchange where instrument is traded
  - `mic_code` (string)
    Market identifier code (MIC) under ISO 10383 standard
  - `country` (string)
    Country where exchange is located
  - `type` (string)
    Common issue type
  - `figi_code` (string)
    Financial instrument global identifier (FIGI)
  - `cfi_code` (string)
    Classification of Financial Instruments (CFI)
  - `isin` (string)
    International securities identification number (ISIN), available by individual request to support
  - `cusip` (string)
    A unique nine-character alphanumeric code used to identify financial securities, ensuring accurate data retrieval for the specified asset
  - `access` (object)
    Info on which plan symbol is available (displayed then `show_plan` is `true`)
    - `global` (string)
      Level of access to the symbol
    - `plan` (string)
      The plan name for the symbol

- `status` (string)
  Response status


## Example Request

```bash
curl "https://api.twelvedata.com/stocks?apikey=demo"
```

## Example Response

```json
{
    "data": [
        {
            "symbol": "AAPL",
            "name": "Apple Inc",
            "currency": "USD",
            "exchange": "NASDAQ",
            "mic_code": "XNGS",
            "country": "United States",
            "type": "Common Stock",
            "figi_code": "BBG000B9Y5X2",
            "cfi_code": "ESVUFR",
            "isin": "US0378331005",
            "cusip": "037833100",
            "access": {
                "global": "Basic",
                "plan": "Basic"
            }
        }
    ],
    "status": "ok"
}
```