# Funds

The funds endpoint provides a daily updated list of available investment funds. It returns an array containing detailed information about each fund, including identifiers, names, and other relevant attributes.

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


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


- `page` (integer, optional)
  Page number of the results to fetch


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



## Response

- `result` (object)
  - `count` (integer)
    Total number of matching instruments
  - `list` (array of object)
    - `symbol` (string)
      Instrument symbol (ticker)
    - `name` (string)
      Full name of the fund
    - `country` (string)
      Country where the fund is located
    - `currency` (string)
      Currency of the fund according to the ISO 4217 standard
    - `exchange` (string)
      Exchange where the fund is traded
    - `mic_code` (string)
      Market identifier code (MIC) under ISO 10383 standard
    - `type` (string)
      Type of the fund
    - `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)
  Status of the response


## Example Request

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

## Example Response

```json
{
    "result": {
        "count": 84799,
        "list": [
            {
                "symbol": "DIVI",
                "name": "AdvisorShares Athena High Dividend ETF",
                "country": "United States",
                "currency": "USD",
                "exchange": "NYSE",
                "mic_code": "ARCX",
                "type": "ETF",
                "figi_code": "BBG00161BCW4",
                "cfi_code": "CECILU",
                "isin": "GB00B65TLW28",
                "cusip": "35473P108",
                "access": {
                    "global": "Basic",
                    "plan": "Basic"
                }
            }
        ]
    },
    "status": "ok"
}
```