ETF-focused metadata and analytics: universe lists, family and type groupings, NAV snapshots, performance metrics, risk measures, and current fund composition. Tailored to the unique characteristics and reporting cadence of exchange-traded funds.
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.
Route
/etfs/listAPI credits cost
1 per request
symbol
stringFilter by symbol
Example:
IVV
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000BVZ697
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US4642872000
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
464287200
cik
stringThe CIK of an instrument for which data is requested
Example:
95953
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
fund_family
stringFilter by investment company that manages the fund
Example:
iShares
fund_type
stringFilter by the type of fund
Example:
Large Blend
format
stringThe format of the response data
Supports: JSON, CSV
Default:
JSON
delimiter
stringThe separator used in the CSV response data
Default:
;
dp
integerNumber of decimal places for floating values
Default:
5
page
integerPage number
Default:
1
outputsize
integerNumber of records in response
Default:
50
Request example
Response
{
"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"
}The ETF full data endpoint provides detailed information about global Exchange-Traded Funds. It returns comprehensive data, including a summary, performance metrics, risk assessment, and composition details. This endpoint is ideal for users seeking an in-depth analysis of worldwide ETFs, enabling them to access key financial metrics and portfolio breakdowns.
Route
/etfs/worldAPI credits cost
800 per request
symbol
stringSymbol ticker of etf
Example:
IVV
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000BVZ697
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US4642872000
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
464287200
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
dp
integerNumber of decimal places for floating values. Accepts value in range [0,11]
Default:
5
Request example
Response
{
"etf": {
"summary": {
"symbol": "IVV",
"name": "iShares Core S&P 500 ETF",
"fund_family": "iShares",
"fund_type": "Large Blend",
"currency": "USD",
"share_class_inception_date": "2000-11-13",
"ytd_return": -0.0537,
"expense_ratio_net": -0.004,
"yield": 0.0133,
"nav": 413.24,
"last_price": 413.24,
"turnover_rate": 0.04,
"net_assets": 753409982464,
"overview": "The investment seeks to track the performance of the Standard & Poor's 500..."
},
"performance": {
"trailing_returns": [
{
"period": "ytd",
"share_class_return": -0.0751,
"category_return": 0.1484
}
],
"annual_total_returns": [
{
"year": 2021,
"share_class_return": 0.2866,
"category_return": 0
}
]
},
"risk": {
"volatility_measures": [
{
"period": "3_year",
"alpha": -0.03,
"alpha_category": -0.02,
"beta": 1,
"beta_category": 0.01,
"mean_annual_return": 1.58,
"mean_annual_return_category": 0.01,
"r_squared": 100,
"r_squared_category": 0.95,
"std": 18.52,
"std_category": 0.19,
"sharpe_ratio": 0.95,
"sharpe_ratio_category": 0.01,
"treynor_ratio": 17.41,
"treynor_ratio_category": 0.16
}
],
"valuation_metrics": {
"price_to_earnings": 26.46,
"price_to_book": 4.42,
"price_to_sales": 2.96,
"price_to_cashflow": 17.57
}
},
"composition": {
"major_market_sectors": [
{
"sector": "Technology",
"weight": 0.2424
}
],
"country_allocation": [
{
"country": "United Kingdom",
"allocation": 0.9855
}
],
"asset_allocation": {
"cash": 0.0004,
"stocks": 0.9996,
"preferred_stocks": 0,
"convertables": 0,
"bonds": 0,
"others": 0
},
"top_holdings": [
{
"symbol": "AAPL",
"name": "Apple Inc",
"exchange": "NASDAQ",
"mic_code": "XNAS",
"weight": 0.0592
}
],
"bond_breakdown": {
"average_maturity": {
"fund": 6.65,
"category": 7.81
},
"average_duration": {
"fund": 5.72,
"category": 5.64
},
"credit_quality": [
{
"grade": "AAA",
"weight": 0
}
]
}
}
},
"status": "ok"
}The ETFs summary endpoint provides a concise overview of global Exchange-Traded Funds. It returns key data points such as ETF names, symbols, and current market values, enabling users to quickly assess the performance and status of various international ETFs. This summary is ideal for users who need a snapshot of the global ETF landscape without delving into detailed analysis.
Route
/etfs/world/summaryAPI credits cost
200 per request
symbol
stringSymbol ticker of etf
Example:
IVV
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000BVZ697
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US4642872000
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
464287200
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
dp
integerNumber of decimal places for floating values. Accepts value in range [0,11]
Default:
5
Response
{
"etf": {
"summary": {
"symbol": "IVV",
"name": "iShares Core S&P 500 ETF",
"fund_family": "iShares",
"fund_type": "Large Blend",
"currency": "USD",
"share_class_inception_date": "2000-11-13",
"ytd_return": -0.0537,
"expense_ratio_net": -0.004,
"yield": 0.0133,
"nav": 413.24,
"last_price": 413.24,
"turnover_rate": 0.04,
"net_assets": 753409982464,
"overview": "The investment seeks to track the performance of the Standard & Poor's 500..."
}
},
"status": "ok"
}The ETFs performance endpoint provides comprehensive performance data for exchange-traded funds globally. It returns detailed metrics such as trailing returns and annual returns, enabling users to evaluate the historical performance of various ETFs. This endpoint is ideal for users looking to compare ETF performance over different time periods and assess their investment potential.
Route
/etfs/world/performanceAPI credits cost
200 per request
symbol
stringSymbol ticker of etf
Example:
IVV
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000BVZ697
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US4642872000
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
464287200
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
dp
integerNumber of decimal places for floating values. Accepts value in range [0,11]
Default:
5
Response
{
"etf": {
"performance": {
"trailing_returns": [
{
"period": "ytd",
"share_class_return": -0.0751,
"category_return": 0.1484
}
],
"annual_total_returns": [
{
"year": 2021,
"share_class_return": 0.2866,
"category_return": 0
}
]
}
},
"status": "ok"
}The ETFs risk endpoint provides essential risk metrics for global Exchange Traded Funds. It returns data such as volatility, beta, and other risk-related indicators, enabling users to assess the potential risk associated with investing in various ETFs worldwide.
Route
/etfs/world/riskAPI credits cost
200 per request
symbol
stringSymbol ticker of etf
Example:
IVV
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000BVZ697
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US4642872000
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
464287200
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
dp
integerNumber of decimal places for floating values. Accepts value in range [0,11]
Default:
5
Response
{
"etf": {
"risk": {
"volatility_measures": [
{
"period": "3_year",
"alpha": -0.03,
"alpha_category": -0.02,
"beta": 1,
"beta_category": 0.01,
"mean_annual_return": 1.58,
"mean_annual_return_category": 0.01,
"r_squared": 100,
"r_squared_category": 0.95,
"std": 18.52,
"std_category": 0.19,
"sharpe_ratio": 0.95,
"sharpe_ratio_category": 0.01,
"treynor_ratio": 17.41,
"treynor_ratio_category": 0.16
}
],
"valuation_metrics": {
"price_to_earnings": 26.46,
"price_to_book": 4.42,
"price_to_sales": 2.96,
"price_to_cashflow": 17.57
}
}
},
"status": "ok"
}The ETFs composition endpoint provides detailed information about the composition of global Exchange-Traded Funds. It returns data on the sectors included in the ETF, specific holding details, and the weighted exposure of each component. This endpoint is useful for users who need to understand the specific makeup and sector distribution of an ETF portfolio.
Route
/etfs/world/compositionAPI credits cost
200 per request
symbol
stringSymbol ticker of etf
Example:
IVV
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG000BVZ697
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
US4642872000
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
464287200
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
dp
integerNumber of decimal places for floating values. Accepts value in range [0,11]
Default:
5
Response
{
"etf": {
"composition": {
"major_market_sectors": [
{
"sector": "Technology",
"weight": 0.2424
}
],
"country_allocation": [
{
"country": "United Kingdom",
"allocation": 0.9855
}
],
"asset_allocation": {
"cash": 0.0004,
"stocks": 0.9996,
"preferred_stocks": 0,
"convertables": 0,
"bonds": 0,
"others": 0
},
"top_holdings": [
{
"symbol": "AAPL",
"name": "Apple Inc",
"exchange": "NASDAQ",
"mic_code": "XNAS",
"weight": 0.0592
}
],
"bond_breakdown": {
"average_maturity": {
"fund": 6.65,
"category": 7.81
},
"average_duration": {
"fund": 5.72,
"category": 5.64
},
"credit_quality": [
{
"grade": "AAA",
"weight": 0
}
]
}
}
},
"status": "ok"
}Retrieve a comprehensive list of exchange-traded fund (ETF) families, providing users with detailed information on various ETF groups available in the market. This endpoint is ideal for users looking to explore different ETF categories, compare offerings, or integrate ETF family data into their financial applications.
Route
/etfs/familyAPI credits cost
1 per request
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
fund_family
stringFilter by investment company that manages the fund
Example:
iShares
Request example
Response
{
"result": {
"India": [
"Aberdeen Standard Fund Managers Limited",
"Aditya Birla Sun Life AMC Ltd"
],
"United States": [
"Aegon Asset Management UK PLC",
"Ampega Investment GmbH",
"Aviva SpA"
]
},
"status": "ok"
}The ETFs Types endpoint provides a concise list of ETF categories by market (e.g., Singapore, United States), including types like "Equity Precious Metals" and "Large Blend." It supports targeted investment research and portfolio diversification.
Route
/etfs/typeAPI credits cost
1 per request
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
fund_type
stringFilter by the type of fund
Example:
Large Blend
Request example
Response
{
"result": {
"Singapore": [
"Property - Indirect Asia",
"Sector Equity Water"
],
"United States": [
"Asia-Pacific ex-Japan Equity",
"EUR Flexible Allocation - Global"
]
},
"status": "ok"
}