# Financial Datasets AI - 13F Institutional Holdings

> Financial Datasets AI - 13F Institutional 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 13F institutional holdings by SEC filer CIK or by held stock ticker, showing each position's shares, dollar value, and reported price from the most recent filing.

## Facts

- Endpoint: GET https://api.financialdatasets.ai/institutional-holdings?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-13f-institutional-holdings-63a289ba
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0gCLBJLw9HLzPYSYvw322

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-13f-institutional-holdings-63a289ba
```

Example prompt: Who are the institutional holders of NVDA according to their most recent 13F filings? Show me up to 20 positions and filter to the 2024-09-30 report period.

## When to prefer this

Choose this endpoint when you need SEC-sourced institutional (13F) ownership data — either to find all funds holding a specific stock or to retrieve a specific fund manager's full portfolio. Prefer this over ETF holdings endpoints for active fund/hedge fund data, and over insider ownership endpoints when you need institutional (not insider) positions. Best for regulatory-grade ownership intelligence derived directly from SEC filings.

## Known failure modes

- Invalid or non-existent filer CIK returns empty results
- Unknown ticker symbol returns empty holdings list
- Malformed report_period date format causes a 400 error
- Missing both ticker and filer_cik returns unfiltered or errored response
- Payment not attached or insufficient USDC balance returns 402 Payment Required
- Professional-use access to large datasets may be blocked without an upgraded plan at financialdatasets.ai

## How this service works

13F institutional holdings by filer CIK or by held ticker: each position's shares, value in dollars and reported price from the filer's most recent 13F, or every filer whose latest 13F holds the ticker; filter by report_period. Use when an agent needs who holds a stock or what a fund manager holds. Non-Professional use; Professional use needs a plan at financialdatasets.ai.

## Output

A paginated list of institutional holding records from SEC 13F filings, each containing the filer's CIK, the held ticker, number of shares, dollar value of the position, reported price per share, and the report period date. Includes a next_page_url cursor for pagination when results exceed the requested limit.

## 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": {
      "limit": {
       "type": "integer",
       "default": 10,
       "description": "The total number of rows to return (default: 10; no maximum)."
      },
      "cursor": {
       "type": "string",
       "description": "Opaque pagination cursor from a previous response's next_page_url."
      },
      "ticker": {
       "type": "string",
       "description": "The held security's ticker symbol."
      },
      "filer_cik": {
       "type": "string",
       "description": "The 10-digit zero-padded SEC CIK of the institutional filer."
      },
      "report_period": {
       "type": "string",
       "description": "Filter by exact report period date in YYYY-MM-DD format."
      },
      "report_period_gt": {
       "type": "string",
       "description": "Filter by report period greater than date in YYYY-MM-DD format."
      },
      "report_period_lt": {
       "type": "string",
       "description": "Filter by report period less than date in YYYY-MM-DD format."
      },
      "report_period_gte": {
       "type": "string",
       "description": "Filter by report period greater than or equal to date in YYYY-MM-DD format."
      },
      "report_period_lte": {
       "type": "string",
       "description": "Filter by report period less than or equal to date in YYYY-MM-DD format."
      }
     }
    }
   },
   "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-13f-institutional-holdings-63a289ba/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)
