tickerbot_get_etf_holdings
Fetch an ETF's constituents, holding weights, and sector mix, heaviest first, for one ticker or a comma-separated list of up to 50; use it to inspect ETF composition or confirm whether a ticker is an ETF.
Instructions
Returns an ETF's constituents and their weights, heaviest first, and its sector weights, for one ETF or a comma list of up to 50. Returns data.holdings and the sector mix data.sectors. When the ticker is not an ETF, data.is_etf is false and both are empty; data.is_etf: true with zero holdings means a real ETF whose holdings are not ingested yet. The reverse lookup ("which ETFs hold NVDA") is the etf_holders signal on tickerbot_get_ticker, or a scan: 'SMH' = ANY(etf_holders).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ticker": "<ticker>"
},
"name": "tickerbot_get_etf_holdings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Holdings per page, per ETF. Max 5000 until 2027-01-12, then 1000 (an over-cap `limit` is clamped to the max, not an error; see Deprecations). When more holdings follow the page, the ETF's object carries `truncated: true` and `total` (its full holding count), and `next_cursor` pages the rest. | |
| cursor | No | Continue paging: the previous response's `next_cursor`, unchanged. Send it with the same params as the first page (`limit` may change); a page whose params differ is a 400 naming the param. On a comma list it carries each ETF's own position, so every ETF continues from its own last holding; a finished one returns an empty `holdings`. | |
| ticker | Yes | ETF symbol, or a comma-separated list of up to 50 for a response keyed by symbol. Case-insensitive. Equities are bare symbols (`NVDA`); every other class carries a prefix: rates (`R:SOFR`), crypto (`X:BTCUSD`), fx (`X:EURUSD`). Bare `BTC`/`ETH` are US-listed ETFs, not spot crypto. See Tickers. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | The ETF's holdings (on the list form, an object keyed by symbol): `is_etf` (from the instrument type on its ticker record), `count` (holdings in this page), `total` (the ETF's full holding count, on every page), `truncated` (`true` when more holdings follow this page, until 2027-01-12; from then `next_cursor` alone says so), `next_cursor` (this ETF alone), `holdings` (constituents, heaviest first, each `holding_ticker` and `weight`, a fraction: `0.0776` is 7.76%) and `sectors` (sector weights, heaviest first, in the vendor's ETF-profile vocabulary; always complete, `limit` is about `holdings`). | |
| as_of | Yes | Server time this response was assembled (ISO 8601); on an as-of read, the instant you asked for (As-of). | |
| count | No | With a comma list: the symbols in `data`, that is, how many of the ETFs asked for were found. Until 2027-01-12 one ETF's read also carries it, as the holdings in this page (the same as `data.count`). | |
| query | Yes | Your request echoed, each param with its effective value: `ticker` (a list even for one ETF) and `limit`. | |
| not_found | No | With a comma list only: the requested symbols we do not track, in request order; an empty array when every symbol was found; every symbol when none was (still a 200). | |
| _advisories | No | Present only when the response carried a warning: `deprecated` (since, sunset_on, successor, warning; on a deprecated tool, successor names the tool to call), `rate_limit` (warning, retry_after_seconds, limit, remaining, reset_epoch_s) or `monthly_quota` (warning, limit, remaining, reset_epoch_s). | |
| next_cursor | Yes | Opaque token for the next page; `null` once every ETF's holdings are complete. Pass it back as `cursor`. |