# 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:** With Basic, <a href="https://twelvedata.com/pricing">Grow</a>, and <a href="https://twelvedata.com/pricing">Pro</a> plans, only 50 records will be in response. <a href="https://twelvedata.com/pricing">Ultra</a>, <a href="https://twelvedata.com/pricing">Enterprise</a> and Custom plans can access complete data on over 46,000 ETFs.

## Parameters

- `symbol` (string, optional)
  Filter by symbol


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


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


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


- `fund_type` (string, optional)
  Filter by the type of fund


- `page` (integer, optional)
  Page number


- `outputsize` (integer, optional)
  Number of records in response



## 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"
}
```