---
title: "ETF Holdings Info"
method: GET
path: "/etfholdings"
tags: ["ETFs"]
---

# ETF Holdings Info

`GET /etfholdings`

ETF Holding Info (timeframe) holding data within a specified date range using a unique ticker identifier. You can adjust the `ticker`, `date_from`, and `date_to` parameters based on your specific needs.

The example API request below demonstrates how to retrieve **stock market index information.**

**Note:**The ETF API endpoints use a **call count multiplier of 20.**

## Query parameters

- `access_key` string, required
- `ticker` string, required
- `date_from` string, date
- `date_to` string, date

## Response `200`

ETF holdings retrieved.

- ETFHoldingsResponse
  - `basics` ETFHoldingsResponseBasics
    - `fund_name` string — Fund name.
    - `file_number` string — SEC file number.
    - `cik` string — SEC CIK of the main trust fund.
    - `reg_lei` string — Legal Entity Identifier of the fund.
  - `output` ETFHoldingsResponseOutput
    - `attributes` ETFAttributes
      - `series_name` string — Name of the ETF series held by the fund.
      - `series_id` string — ID of the ETF held by the fund.
      - `series_lei` string — Legal Entity Identifier of the ETF series.
      - `ticker` string — ETF ticker.
      - `isin` string — International Securities Identification Number.
      - `date_report_period` string — Start date of the report period.
      - `end_report_period` string — End date of the report period.
      - `final_filing` boolean — Indicates whether this is the final filing.
    - `signature` ETFSignature
      - `date_signed` string — Signature date.
      - `name_of_applicant` string — Name of the applicant.
      - `signature` string — Signature text.
      - `signer_name` string — Name of the signer.
      - `title` string — Signer's title.
    - `holdings` ETFHoldingsResponseOutputHoldings[]
      - `investment_security` ETFHoldingSecurity
        - `lei` string — Legal Entity Identifier.
        - `isin` string — International Securities Identification Number.
        - `name` string — Holding name.
        - `cusip` string — U.S./Canada security identifier (CUSIP).
        - `title` string — Holding title.
        - `units` string — Unit type.
        - `balance` string — Holding balance.
        - `currency` string — Currency code.
        - `value_usd` string — Holding value in USD.
        - `loan_by_fund` string — Whether the holding is loaned by the fund.
        - `percent_value` string — Portfolio percentage weight.
        - `asset_category` string — Asset category.
        - `payoff_profile` string — Payoff profile.
        - `restricted_sec` string — Restricted security flag.
        - `cash_collateral` string — Cash collateral flag.
        - `issuer_category` string — Issuer category.
        - `fair_value_level` string — Fair value level.
        - `invested_country` string — Invested country code.
        - `non_cash_collateral` string — Non-cash collateral flag.

---

[API](https://skmtc.net/beavermoney/apis/marketstack-api-v2.md) · [All operations](https://skmtc.net/beavermoney/apis/marketstack-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/beavermoney/marketstack-api-v2/revisions/c3305aea713e/schema)
