# ETFs

The ETFs endpoint provides a daily updated list of all available Exchange-Traded Funds. It returns an array containing detailed information about each ETF, including its symbol, name, and other relevant identifiers. This endpoint is useful for retrieving a comprehensive catalog of ETFs for portfolio management, investment tracking, or financial analysis.

**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`


- `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 ETFs
  - `symbol` (string)
    Instrument symbol (ticker)
  - `name` (string)
    Full name of the ETF
  - `currency` (string)
    Currency of the ETF according to the ISO 4217 standard
  - `exchange` (string)
    Exchange where the ETF is traded
  - `mic_code` (string)
    Market identifier code (MIC) under ISO 10383 standard
  - `country` (string)
    Country where the ETF is located
  - `figi_code` (string)
    Financial instrument global identifier (FIGI)
  - `cfi_code` (string)
    Classification of Financial Instruments (CFI)
  - `isin` (string)
    International securities identification number (ISIN)
  - `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/etfs?apikey=demo"
```

## Example Response

```json
{
    "data": [
        {
            "symbol": "SPY",
            "name": "SPDR S&P 500 ETF Trust",
            "currency": "USD",
            "exchange": "NYSE",
            "mic_code": "ARCX",
            "country": "United States",
            "figi_code": "BBG000BDTF76",
            "cfi_code": "CECILU",
            "isin": "US78462F1030",
            "cusip": "037833100",
            "access": {
                "global": "Basic",
                "plan": "Basic"
            }
        }
    ],
    "status": "ok"
}
```