---
title: "Get ETF Holdings"
method: GET
path: "/etf/holdings/{symbol}"
tags: ["ETF"]
---

# Get ETF Holdings

`GET /etf/holdings/{symbol}`

## Request

- Base URL: `https://data.finbud.ai/api`
- URL: `https://data.finbud.ai/api/etf/holdings/{symbol}`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/laksmono---company/apis/finbud-api/docs/etf/holdings/:symbol/get.ts> (a function with typed inputs; its response is checked against the schema)

Fetches the underlying holdings for a specific Exchange Traded Fund (ETF) symbol.

## Path parameters

- `symbol` string, required

## Query parameters

- `date` string, date

## Response `200`

Successful response with an array of ETF holdings.

- object[]
  - `asset` string
  - `cusip` string
  - `isin` string
  - `sedol` string, nullable
  - `symbol` string
  - `shares-number` number
  - `market-value-percentage` number
  - `weight-percentage` number
  - `date` string, date

## Other responses

- `400`: Bad Request - Symbol parameter missing or invalid date format.
- `404`: Not Found - No holdings found for the requested ETF symbol or date.
- `500`: Internal Server Error - Failed to fetch data or other server error.

---

[API](https://skmtc.dev/laksmono---company/apis/finbud-api.md) - [All operations](https://skmtc.dev/laksmono---company/apis/finbud-api/llms.txt) - [OpenAPI document](https://skmtc.dev/laksmono---company/apis/finbud-api/revisions/742d2654c09a?raw)