# 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
  Example value: `AAPL`


- `figi` (string, optional)
  Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
  Example value: `BBG000B9Y5X2`


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


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


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


- `exchange` (string, optional)
  Filter by exchange name
  Example value: `NASDAQ`


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


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


- `type` (string, optional)
  The asset class to which the instrument belongs
  Example value: `Common Stock`
  Available values: `American Depositary Receipt`, `Bond`, `Bond Fund`, `Closed-end Fund`, `Common Stock`, `Depositary Receipt`, `Digital Currency`, `ETF`, `Exchange-Traded Note`, `Global Depositary Receipt`, `Limited Partnership`, `Mutual Fund`, `Physical Currency`, `Preferred Stock`, `REIT`, `Right`, `Structured Product`, `Trust`, `Unit`, `Warrant`


- `format` (string, optional)
  The format of the response data
  Available values: `JSON`, `CSV`
  Default value: `JSON`


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


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


- `include_delisted` (boolean, optional)
  Include delisted identifiers
  Default value: `false`


- `page` (integer, optional)
  Page number of the results to fetch
  Default value: `1`


- `outputsize` (integer, optional)
  Determines the number of data points returned in the output



## Response

- `count` (integer)
  Count

- `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 individual plan name for the symbol
    - `plan_business` (string)
      The business plan name for the symbol

- `status` (string)
  Response status


## Example Request

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

## Example Response

```json
{
    "count": 100,
    "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",
                "plan_business": "Basic"
            }
        }
    ],
    "status": "ok"
}
```