# Financial Datasets AI – ETF & Index Fund Holdings

> Financial Datasets AI – ETF & Index Fund Holdings is a paid API for AI agents from api.financialdatasets.ai, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-18).

Returns the constituent holdings and weights of an ETF/index fund by ticker, or lists all funds whose latest filing holds a specified security, sorted by weight.

## Facts

- Endpoint: GET https://api.financialdatasets.ai/index-funds?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/financial-datasets-ai-etf-index-fund-holdings-86c9f0d0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wAh83PHZ7uKjTISZGVZ-D

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability financial-datasets-ai-etf-index-fund-holdings-86c9f0d0
```

Example prompt: What are the current equity holdings of SPY — show me all constituents and their weights, up to 100 results?

## When to prefer this

Use this endpoint when an agent needs to know what securities are inside a specific ETF or index fund (constituent lookup), or needs to find which ETFs/funds hold a particular stock. Prefer over 13F institutional holdings data when the focus is on passive index funds rather than active institutional managers, and when fund composition weights and asset class breakdowns are needed.

## Known failure modes

- Missing both 'ticker' and 'holding' parameters — must supply at least one
- 'as_of' date provided without 'ticker' — only valid when querying by fund
- 'asset_class' filter used without 'ticker' — only valid for fund constituent queries
- Ticker not found or no filings available — returns empty results
- Rate limit or payment failure — HTTP 402 if x402 payment not processed
- Invalid date format for 'as_of' — must be YYYY-MM-DD

## How this service works

ETF and index fund holdings in two directions: the constituents and weights of one fund by its ticker (latest filing, or as of a date), or every fund whose latest filing holds a given security, sorted by weight. Use when an agent needs what is inside an ETF or which funds hold a stock. Non-Professional use; Professional use needs a plan at financialdatasets.ai.

## Output

A paginated list of rows where each row represents a fund-security holding relationship, including the fund ticker, the held security ticker, its weight in the portfolio, and asset class. When querying by fund ticker, the response lists all constituent securities and their weights. When querying by held security, the response lists all funds that hold that security, sorted by weight. Includes a next_page_url cursor for pagination.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "as_of": {
       "type": "string",
       "description": "Only valid with ticker: the fund composition in effect on or before this date (YYYY-MM-DD); without it, the latest filing."
      },
      "limit": {
       "type": "integer",
       "default": 50,
       "description": "The total number of rows to return (default: 50; no maximum)."
      },
      "cursor": {
       "type": "string",
       "description": "Opaque pagination cursor from a previous response's next_page_url."
      },
      "offset": {
       "type": "integer",
       "default": 0,
       "description": "The number of rows to skip, for pagination (default: 0)."
      },
      "ticker": {
       "type": "string",
       "description": "The fund's ticker symbol (e.g., SPY)."
      },
      "holding": {
       "type": "string",
       "description": "A held security's ticker symbol (e.g., AAPL)."
      },
      "asset_class": {
       "enum": [
        "equity",
        "bond"
       ],
       "type": "string",
       "description": "Only valid with ticker: keep only equity or only bond constituents."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/financial-datasets-ai-etf-index-fund-holdings-86c9f0d0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.financialdatasets.ai](https://www.zero.xyz/host/api.financialdatasets.ai/llms.txt)
