Default

ETFs Holdings

Get full ETF holdings/constituents. This endpoint has global coverage. Widget only shows top 10 holdings. A list of supported ETFs can be found <a href="/api/v1/etf/list?token=" target="_blank">here</a>.

get/etf/holdings

Query parameters

symbolstring

ETF symbol.

isinstring

ETF isin.

skipinteger

Skip the first n results. You can use this parameter to query historical constituents data. The latest result is returned if skip=0 or not set.

datestring

Query holdings by date. You can use either this param or <code>skip</code> param, not both.

Response

successful operation

symbolstring

ETF symbol.

atDatestring date

Holdings update date.

numberOfHoldingsinteger

Number of holdings.

Example response

{
  "symbol": "symbol",
  "atDate": "2000-01-23",
  "holdings": [
    {
      "symbol": "symbol",
      "cusip": "cusip",
      "name": "name",
      "share": 6.0274563,
      "percent": 1.4658129,
      "value": 5.962134,
      "isin": "isin",
      "assetType": "assetType"
    },
    {
      "symbol": "symbol",
      "cusip": "cusip",
      "name": "name",
      "share": 6.0274563,
      "percent": 1.4658129,
      "value": 5.962134,
      "isin": "isin",
      "assetType": "assetType"
    }
  ],
  "numberOfHoldings": 0
}

Changes

Changed in 6 of the 35 revisions of this API.116

Mar 31, 2023fe3acff4e0d71See the full diff
- ○
  added the optional property // to the response with the status
  response-optional-property-added
Mar 15, 2022c179bf4194001See the full diff
- ○
  added the new optional query request parameter date
  new-optional-request-parameter
Jul 26, 20210f755a71e9037See the full diff
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
This revision also has 12 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 23, 2021a148c0b2d5836See the full diff
- ○
  api tag Default added
  api-tag-added
- ○
  added the new optional query request parameter isin
  new-optional-request-parameter
- ○
  added the new optional query request parameter skip
  new-optional-request-parameter
- ○
  the query request parameter symbol became optional
  request-parameter-became-optional
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 1, 2020e30753df924e1See the full diff
- ○
  endpoint added
  endpoint-added
May 26, 2020c5b8e420b78c1See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 146 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history