# ETF & Mutual Fund N-PORT Holdings Lookup

> ETF & Mutual Fund N-PORT Holdings Lookup is a paid API for AI agents from agents.x402stock.xyz, paid per call via MPP, $0.03/call, status unknown (last checked 2026-09-13).

Returns the full portfolio holdings of an ETF or mutual fund from its latest SEC N-PORT filing, including registrant info, net/total assets, and every position with CUSIP, ISIN, shares, USD value, and % of net assets.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/fund-nport/{fund}
- Price: $0.03/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Provider: agents.x402stock.xyz
- Website: https://agents.x402stock.xyz
- Canonical page: https://www.zero.xyz/c/agents-x402stock-xyz-etf-mutual-fund-n-port-holdings-lookup-7d5db20a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Up1zo7BlDY1glKl1m8hIJ

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 agents-x402stock-xyz-etf-mutual-fund-n-port-holdings-lookup-7d5db20a
```

Example prompt: Pull the latest SEC N-PORT holdings for SPY — I want to see all the positions including their CUSIP, USD value, and percentage of net assets, up to 500 holdings.

## When to prefer this

Use this endpoint when you need the complete portfolio composition of a registered ETF or mutual fund as reported to the SEC via Form N-PORT — particularly when you need CUSIP, ISIN, share counts, and exact USD valuations not available in 13F feeds. Prefer this over 13F-based feeds for ETFs and mutual funds specifically, and when regulatory filing accuracy matters over real-time market data.

## Known failure modes

- Unknown ticker or CIK returns a 404 or empty result
- Fund has not filed an N-PORT (e.g., hedge funds, private funds) — no data returned
- Limit parameter exceeds 500 — request rejected
- SEC EDGAR data lag may mean latest filing is a quarter old
- Truncated holdings if limit is set below total positions count

## How this service works

What's inside an ETF or mutual fund, from its latest SEC N-PORT filing. Pass an ETF/fund ticker (SPY, ARKK) or CIK in the path. Returns the registrant, net/total assets, report date, and every portfolio holding by value — name, CUSIP, ISIN, shares, USD value, % of net assets, asset/issuer class, country. `?limit=` (max 500). Fund composition the 13F feed doesn't cover. From x402stock

## Output

A JSON object containing the fund's CIK, registrant name, source, as-of date, and a data block with series name, form type, accession number, filing date, report date, total assets, total liabilities, net assets, total position count, and an array of holdings each with name, title, CUSIP, ISIN, LEI, balance, units, currency, USD value, percent of net assets, payoff profile, asset category, issuer category, and country.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "fund"
 ],
 "properties": {
  "fund": {
   "type": "string",
   "description": "Fund identifier (SEC CIK or ticker) for the N-PORT holdings lookup."
  },
  "limit": {
   "type": "integer",
   "default": 50,
   "maximum": 500,
   "exclusiveMinimum": 0
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "cik",
  "registrant",
  "source",
  "as_of",
  "data"
 ],
 "properties": {
  "cik": {
   "type": "string"
  },
  "data": {
   "type": "object",
   "required": [
    "series_name",
    "series_id",
    "form",
    "accession",
    "filing_date",
    "report_date",
    "report_period_end",
    "total_assets",
    "total_liabilities",
    "net_assets",
    "total_positions",
    "count",
    "holdings"
   ],
   "properties": {
    "form": {
     "type": "string"
    },
    "count": {
     "type": "number"
    },
    "holdings": {
     "type": "array",
     "items": {
      "type": "object",
      "required": [
       "name",
       "title",
       "cusip",
       "isin",
       "lei",
       "balance",
       "units",
       "currency",
       "value_usd",
       "pct_value",
       "payoff_profile",
       "asset_category",
       "issuer_category",
       "country"
      ],
      "properties": {
       "lei": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       },
       "isin": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       },
       "name": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       },
       "cusip": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       },
       "title": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       },
       "units": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       },
       "balance": {
        "anyOf": [
         {
          "type": "number"
         },
         {
          "type": "null"
         }
        ]
       },
       "country": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       },
       "currency": {
        "anyOf": [
         {
          "type": "string"
         },
         {
          "type": "null"
         }
        ]
       },
       "pct_value": {
        "anyOf": [
         {
          "type": "number"
         },
         {
          "type": "null"
         }
        ]
       },
      
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-x402stock-xyz-etf-mutual-fund-n-port-holdings-lookup-7d5db20a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.x402stock.xyz](https://www.zero.xyz/host/agents.x402stock.xyz/llms.txt)