# x402stock Fund NPORT Holdings Lookup > x402stock Fund NPORT Holdings Lookup is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-08). Retrieves SEC NPORT-P filing data for a mutual fund or ETF, including all portfolio holdings with valuations, asset categories, and fund-level balance sheet figures. ## Facts - Endpoint: GET https://x402stock.xyz/api/v1/fund-nport/%7Bfund%7D - Price: $0.03/call - Payment: x402 - Status: unknown - Last checked: 2026-09-08 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/x402stock-fund-nport-holdings-lookup-3a297011 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cLm3Pvs2-Nxs4c_wBVTk6 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 x402stock-fund-nport-holdings-lookup-3a297011 ``` Example prompt: Pull the latest SEC NPORT-P filing for the State Street SPDR S&P 500 ETF Trust and show me its top 50 holdings with their USD values, percentage of the portfolio, and asset categories. ## When to prefer this Use this endpoint when you need structured SEC NPORT-P portfolio holdings data for a specific mutual fund or ETF — especially when you need CUSIP/ISIN-level detail, asset categories, USD valuations, and fund-level balance sheet figures sourced directly from SEC EDGAR. Prefer this over generic stock screeners when regulatory filing accuracy and full position-level detail matter. ## Known failure modes - Unknown or invalid fund identifier returns 404 or empty result - Fund has no NPORT-P filing on record — returns empty data - Limit parameter out of range (must be 1–500) returns validation error - Payment failure (insufficient USDC balance or x402 protocol error) blocks the request - SEC EDGAR data may lag by weeks after the report period end ## How this service works Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base. ## Output Returns a JSON object containing fund registrant name, CIK, source (sec_edgar), as-of date, and a data object with series name, form type, accession number, filing date, report date, report period end, total assets, total liabilities, net assets, total positions, holdings count, and a full holdings array. Each holding includes name, title, CUSIP, ISIN, LEI, balance, units, currency, USD value, percent of total value, payoff profile, asset category, issuer category, and country. ## 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", "required": [ "limit" ], "properties": { "limit": { "type": "integer", "default": 50, "maximum": 500, "exclusiveMinimum": 0 } }, "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", "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" }, { … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "cik": "0000884394", "data": { "form": "NPORT-P", "count": 1, "holdings": [ { "lei": "HWUPKR0MPOU8FGXBT394", "isin": "US0378331005", "name": "Apple Inc", "cusip": "037833100", "title": "Apple Inc", "units": "NS", "balance": 41000000, "country": "US", "currency": "USD", "pct_value": 1.304, "value_usd": 8500000000, "asset_category": "EC", "payoff_profile": "Long", "issuer_category": "CORP" } ], "accession": "0001410368-26-055357", "series_id": null, "net_assets": 651588269947.59, "filing_date": "2026-05-28", "report_date": "2026-03-31", "series_name": null, "total_assets": 653587391058.59, "total_positions": 503, "report_period_end": "2026-09-30", "total_liabilities": 1999121111 }, "as_of": "2026-03-31T00:00:00.000Z", "source": "sec_edgar", "registrant": "State Street SPDR S&P 500 ETF Trust" } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-fund-nport-holdings-lookup-3a297011/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)