# StableFinance Index Fund Holdings Lookup

> StableFinance Index Fund Holdings Lookup is a paid API for AI agents from stablefinance.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-13).

Retrieves ETF/index-fund holdings by fund ticker, or finds which funds hold a given security, with optional date and asset class filtering.

## Facts

- Endpoint: GET https://stablefinance.dev/api/index-funds
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stablefinance-index-fund-holdings-lookup-7fae65ed
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4gqzJy_YH3Pa7FQpnn3B3

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 stablefinance-index-fund-holdings-lookup-7fae65ed
```

Example prompt: What are the current equity holdings of QQQ — I want to see every stock it holds, up to 100 results?

## When to prefer this

Use this endpoint when you need to look up what securities a specific ETF or index fund holds, or to identify which funds contain a particular stock or bond. It is ideal for portfolio transparency, overlap analysis, or fund comparison tasks. Prefer this over general market data APIs when you specifically need fund composition and holdings data.

## Known failure modes

- Invalid or unknown ticker returns empty results or 404
- Invalid date format for as_of (must be YYYY-MM-DD) returns 400
- Exceeding limit maximum of 1000 returns validation error
- No matching funds for the given holding ticker returns empty list
- Payment not completed or insufficient USDC balance returns 402

## How this service works

ETF / index-fund holdings by fund ticker, or the funds holding a given security.

## Output

Returns a fund object with its metadata and a holdings array listing each security the fund holds (or, when querying by holding, a list of funds that contain that security), including details like security identifiers and allocation data.

## 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",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "properties": {
      "as_of": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
      },
      "limit": {
       "type": "integer",
       "maximum": 1000,
       "minimum": 1
      },
      "offset": {
       "type": "integer",
       "maximum": 9007199254740991,
       "minimum": 0
      },
      "ticker": {
       "type": "string",
       "minLength": 1
      },
      "holding": {
       "type": "string",
       "minLength": 1
      },
      "asset_class": {
       "enum": [
        "equity",
        "bond"
       ],
       "type": "string"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "properties": {
      "fund": {
       "type": "object",
       "propertyNames": {
        "type": "string"
       },
       "additionalProperties": {}
      },
      "funds": {
       "type": "array",
       "items": {}
      },
      "ticker": {
       "type": "string"
      },
      "holding": {
       "type": "string"
      },
      "holdings": {
       "type": "array",
       "items": {}
      },
      "security": {
       "type": "object",
       "propertyNames": {
        "type": "string"
       },
       "additionalProperties": {}
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "fund": {
   "name": "SPDR S&P 500 ETF Trust",
   "as_of": "2026-05-28",
   "ticker": "SPY",
   "asset_class": "equity",
   "total_assets": 615000000000
  },
  "ticker": "SPY",
  "holdings": [
   {
    "name": "Apple Inc",
    "shares": 178500000,
    "ticker": "AAPL",
    "weight": 0.071,
    "market_value": 55700000000
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stablefinance-index-fund-holdings-lookup-7fae65ed/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablefinance.dev](https://www.zero.xyz/host/stablefinance.dev/llms.txt)