ETF Holdings API — Historical and Real-time ETF Data for Developers
Tags: api, developers, etfdata, financialdata
Published: 2023-02-17 13:07:04

**[Finnworlds' ETF Holdings API](https://finnworlds.com/financial-data/etf-holdings-api/)** offers developers **real-time and historical ETF data** and the assets they contain individually. The API is especially useful for companies and financial institutions seeking to create efficient and comprehensive **ETF portfolio tracking services** or to fetch and process reliable ETF data to support these services. The API provides data via REST APIs in **JSON** format, but other formats such as **XML, PDF, and email download links** are also available.

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/t4fk4yivewtqnzd0n1v0.jpeg)

--------

### What You Can Do With The ETF Holdings API

As ETFs become increasingly popular, this ETF API provides a competitive edge for companies in the finance sector, allowing them to track and analyze the ETFs they invest in or offer this service to their clients. **Investment managers, portfolio managers, research analysts, data scientists, stockbrokers, traders, and online trading platforms** can all benefit from the ETF holdings data insights provided by the ETF API.

The ETF Holdings API can be used for a variety of purposes, including:
- **ETF portfolio analysis** via real-time ETF holdings data,
- **ETF comparison and analysis** of how ETFs perform over time by using historical ETF holdings data,
- Correct **ETF investment recommendation** and ETF market monitoring
- **Mockup projects** to practice app development in the finance sector

-------

### Essentials for Developers

Finnworlds ETF API allows filtering ETF holdings data by ETF ticker symbol and ISIN identifier, as well as holding stock ticker and ISIN identifier. These are the most common identifiers for ETF data, so it is essential for your clients who use your app to be able to track their ETF portfolio with these codes. You can build features with our API where your clients can track the ETFs of their choice, as well as individual assets in them, by their codes. 

It is also possible to specify a date or a date range to access **historical ETF holdings data**.

Filter the ETF data by using these parameters (with examples):

- /etfinfo&cik=1137095
- /etfinfo&cik=1137095&series_id=S000005505
- /etfreturns&series_id=S000005505
&date_from=2020-09-01&date_to=2020-12-30
- /etfholdings&series_id=S000005505
&date_from=2020-09-01&date_to=2020-12-30 

#### JSON Output:

```
https://api.finnworlds.com/api/v1/etfinfo
    ?key=API-KEY
        &cik=1137095


{
    "status": {
        "code": 200,
        "message": "OK",
        "details": ""
    },
    "result": {
        "basics": {
            "fund_name": "USA Mutuals",
            "file_number": "811-10319",
            "cik": "0001137095",
            "reg_lei": "549300IJ0KFT977YGX93"
        },
        "output": [
            {
                "general": {
                    "fund_name": "USA Mutuals",
                    "cik": "0001137095",
                    "reg_lei": "549300IJ0KFT977YGX93",
                    "country": "US",
                    "state": "US-TX",
                    "city": "Dallas",
                    "zip": "75201",
                    "street": "700 N. Pearl Street",
                    "phone": "866-264-8783"
                },
                "attributes": {
                    "series_name": "USA Mutuals Vitium Global Fund",
                    "series_id": "S000005505",
                    "series_lei": "549300GX5CPIZQ5PDX31",
                    "date_report_period": "2020-12-31",
                    "end_report_period": "2021-03-31",
                    "final_filing": 1
                },
                "fund_info": {
                    "total_assets": "111438858.600000000000",
                    "total_liabilities": "1741129.050000000000",
                    "net_assets": "109697729.550000000000",
                    "assets_attr_misc_sec": "0.000000000000",
                    "invested_assets": "0.000000000000",
                    "one_yr_banks_borr": "591000.000000000000",
                    "one_yr_ctrld_comp": "0.000000000000",
                    "one_yr_oth_affil": "0.000000000000",
                    "one_yr_other": "0.000000000000",
                    "aft_one_yr_banks_borr": "0.000000000000",
                    "aft_one_yr_ctrld_comp": "0.000000000000",
                    "aft_one_yr_oth_affil": "0.000000000000",
                    "aft_one_yr_other": "0.000000000000",
                    "delivery_delay": "0.000000000000",
                    "standby_commit": "0.000000000000",
                    "liquid_pref": "0.000000000000",
                    "cash_not_reported_in_cor_d": "2545141.120000000000",
                    "non_cash_collateral": "N",
                    "currency": "Null"
                }
            },
            {
                "general": {
                    "fund_name": "USA Mutuals",
                    "cik": "0001137095",
                    "reg_lei": "549300IJ0KFT977YGX93",
                    "country": "US",
                    "state": "US-TX",
                    "city": "Dallas",
                    "zip": "75201",
                    "street": "700 N. Pearl Street",
                    "phone": "866-264-8783"
                },
                "attributes": {
                    "series_name": "USA Mutuals Navigator Fund",
                    "series_id": "S000058976",
                    "series_lei": "549300CS0EIS27ZLBG68",
                    "date_report_period": "2020-12-31",
                    "end_report_period": "2021-03-31",
                    "final_filing": 1
                },
                "fund_info": {
                    "total_assets": "44290035.570000000000",
                    "total_liabilities": "208427.160000000000",
                    "net_assets": "44081608.410000000000",
                    "assets_attr_misc_sec": "0.000000000000",
                    "invested_assets": "0.000000000000",
                    "one_yr_banks_borr": "0.000000000000",
                    "one_yr_ctrld_comp": "0.000000000000",
                    "one_yr_oth_affil": "0.000000000000",
                    "one_yr_other": "0.000000000000",
                    "aft_one_yr_banks_borr": "0.000000000000",
                    "aft_one_yr_ctrld_comp": "0.000000000000",
                    "aft_one_yr_oth_affil": "0.000000000000",
                    "aft_one_yr_other": "0.000000000000",
                    "delivery_delay": "0.000000000000",
                    "standby_commit": "0.000000000000",
                    "liquid_pref": "0.000000000000",
                    "cash_not_reported_in_cor_d": "34462732.210000000000",
                    "non_cash_collateral": "N",
                    "currency": "Null"
                }
            }
        ]
    }
}
```

Visit our full **documentation** below, you may be interested in our other APIs as well!

{% embed https://finnworlds.com/documentation/ %}

--------

### Sources and How To Access To the API

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/0oy5b9eg4j8uzkkuu6wn.jpeg)

Finnworlds aggregates ETF data as reported to the relevant authority of the country or region which ensures the data accuracy. The API includes **daily, weekly, quarterly, annual, or irregular updates** and provides historical ETF data dating back to the first listing date of the ETF.

If everything sounds good so far, feel free to **get an API key below** and test the data. Testing grants access to our complete data to make sure you have a clear understanding of the data.

{% embed https://finnworlds.com/pricing/ %}

For any questions, requests or additional data needs, you may [**contact us anytime**](https://finnworlds.com/contact/) and we will get back to you!