# Heurist Mesh SEC 13F Institutional Holders

> Heurist Mesh SEC 13F Institutional Holders is a paid API for AI agents from mesh.heurist.xyz, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Returns the top institutional holders of a given issuer from the latest SEC 13F filings, ranked by reported position value.

## Facts

- Endpoint: POST https://mesh.heurist.xyz/x402/solana/agents/SecEdgarAgent/institutional_holders
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/heurist-mesh-sec-13f-institutional-holders-929bc355
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_e7OFk0bnxvgE3GXQoaXgJ

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 heurist-mesh-sec-13f-institutional-holders-929bc355 -d '<json body>'
```

Example prompt: Who are the top institutional holders of Nvidia right now? Pull the latest SEC 13F data and rank them by reported position value.

## When to prefer this

Use this endpoint when you need structured, authoritative institutional ownership data sourced directly from SEC 13F regulatory filings. Prefer this over Twitter sentiment or market data endpoints when the user wants verified, official ownership positions rather than inferred or real-time estimates. Best for equity research, due diligence, or tracking large institutional moves.

## Known failure modes

- Unknown or misspelled issuer name returns no results or an error
- Issuer not found in SEC EDGAR 13F dataset (e.g. private company or foreign issuer)
- Data may lag by one quarter since 13F filings are filed 45 days after quarter-end
- Rate limiting or payment failure returns 402 or 429 error

## How this service works

Return the top institutional holders of an issuer from the latest SEC 13F dataset, ranked by reported position value. Use this for institutional ownership questions.

## Output

A ranked list of the top institutional holders for the specified issuer, drawn from the latest SEC 13F dataset. Each entry typically includes the institution name, reported position value in USD, number of shares held, and filing period. Results are sorted by position value in descending order.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "debug": {
       "type": "boolean",
       "default": false,
       "description": "Debug mode flag. ALWAYS use false."
      },
      "limit": {
       "type": "integer",
       "default": 10,
       "description": "Maximum number of holder rows to return."
      },
      "query": {
       "type": "string",
       "description": "Company name, ticker, or CIK."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "result": {
       "type": "object",
       "additionalProperties": true
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/heurist-mesh-sec-13f-institutional-holders-929bc355/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mesh.heurist.xyz](https://www.zero.xyz/host/mesh.heurist.xyz/llms.txt)