# ETFs directory (Useful)

The ETFs directory endpoint provides a daily updated list of exchange-traded funds, sorted by total assets in descending order. This endpoint is useful for retrieving comprehensive ETF data, including fund names and asset values, to assist users in quickly identifying the ETFs available.

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

> **Note:** Basic, <a href="https://twelvedata.com/pricing">Grow</a>, and <a href="https://twelvedata.com/pricing">Pro</a> plans (individual) and <a href="https://twelvedata.com/pricing-business">Venture</a> plan (business) return up to 50 records. For complete data on over 40,000 ETFs, upgrade to the <a href="https://twelvedata.com/pricing">Ultra</a> plan (individual), <a href="https://twelvedata.com/pricing-business">Enterprise</a> (business), or Custom plan (business).

## Parameters

- `symbol` (string, optional)
  Filter by symbol
  Example value: `IVV`


- `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: `BBG000BVZ697`


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


- `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: `464287200`


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


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


- `fund_family` (string, optional)
  Filter by investment company that manages the fund
  Example value: `iShares`


- `fund_type` (string, optional)
  Filter by the type of fund
  Example value: `Large Blend`


- `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: `;`


- `dp` (integer, optional)
  Number of decimal places for floating values
  Default value: `5`


- `page` (integer, optional)
  Page number
  Default value: `1`


- `outputsize` (integer, optional)
  Number of records in response
  Default value: `50`



## Response

- `result` (object)
  - `count` (integer)
    Total number of matching funds
  - `list` (array of object)
    List of ETFs
    - `symbol` (string)
      Instrument symbol (ticker)
    - `name` (string)
      Full name of the fund
    - `country` (string)
      Country of fund incorporation
    - `mic_code` (string)
      Market identifier code (MIC) under ISO 10383 standard
    - `fund_family` (string)
      Investment company that manages the fund
    - `fund_type` (string)
      Type of fund

- `status` (string)
  Status of the response


## Example Request

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

## Example Response

```json
{
    "result": {
        "count": 1000,
        "list": [
            {
                "symbol": "IVV",
                "name": "iShares Core S&P 500 ETF",
                "country": "United States",
                "mic_code": "XNAS",
                "fund_family": "iShares",
                "fund_type": "Large Blend"
            }
        ]
    },
    "status": "ok"
}
```