latestSwagger 2.02026-08-12187723.0 MB

c4a12725cdb5

etfs

Performance

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.

get/etfs/world/performance

Query parameters

symbolstring

Symbol ticker of etf

figistring

Filter by financial instrument global identifier (FIGI). This parameter is available on the <a href="https://twelvedata.com/pricing">Ultra</a> plan (individual) and the <a href="https://twelvedata.com/pricing-business">Enterprise</a> plan (business) and above.

isinstring

Filter by international securities identification number (ISIN). ISIN access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section

cusipstring

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section

countrystring

Filter by country name or alpha code, e.g., United States or US

dpinteger

Number of decimal places for floating values. Accepts value in range [0,11]

Response

statusstring required

Status of the response

Example 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
        }
      ]
    }
  },
  "status": "ok"
}