# EDGAR 13F Dataset Head

> EDGAR 13F Dataset Head is a paid API for AI agents from agent402.tools, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-16).

Returns the first N rows of a selected table from an SEC EDGAR Form 13F institutional holdings dataset (latest or specified quarter).

## Facts

- Endpoint: GET https://agent402.tools/api/edgar-13f-dataset-head?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/edgar-13f-dataset-head-1ad15673
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mlNU9pS1dA-anUUalyXiT

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 edgar-13f-dataset-head-1ad15673
```

Example prompt: Pull the first 50 rows from the INFOTABLE of the latest SEC EDGAR 13F dataset so I can see what columns and filing entries are available.

## When to prefer this

Use this endpoint when you need a quick preview or structural sample of SEC EDGAR Form 13F institutional holdings data without downloading the full dataset ZIP. It's ideal for exploring table schemas, validating column names, or sampling a small number of rows for analysis before committing to a full data pull. Prefer this over direct SEC file downloads when you need fast, structured JSON output without handling ZIP extraction yourself.

## Known failure modes

- Invalid table name returns an error — only SUBMISSION, COVERPAGE, OTHERMANAGER, OTHERMANAGER2, SIGNATURE, SUMMARYPAGE, or INFOTABLE are accepted
- Invalid dataset ID (not matching any available quarter) returns an error
- rows parameter outside 1-200 range may be rejected or clamped
- Dataset not yet published for a future quarter returns an empty or error response
- Network timeout if the source SEC ZIP file is very large or temporarily unavailable

## How this service works

A bounded head of ONE table in a Form 13F data set, read with two byte-range requests against sec.gov (the archive's central directory plus the first 256 KB of the chosen table) so the multi-hundred-MB zip is never downloaded. Returns the archive's members with sizes, the table's columns and its first rows (1-200, default 25) as objects: SUMMARYPAGE (per filing: holdings count, total value, confidential-omission flag), SUBMISSION (accession, filer CIK, period, form), COVERPAGE (manager name and.

## Output

Returns a JSON object containing sampled rows from the requested 13F table, column names, the source ZIP URL, dataset metadata (ID, date range, size in MB), archive member details, and flags indicating whether the result is partial and how many rows were returned.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "rows": {
       "type": "number",
       "description": "Rows to return from the head of the table (1-200, default 25)."
      },
      "table": {
       "type": "string",
       "description": "SUBMISSION, COVERPAGE, OTHERMANAGER, OTHERMANAGER2, SIGNATURE, SUMMARYPAGE (default) or INFOTABLE."
      },
      "dataSet": {
       "type": "string",
       "description": "Data set id from edgar-13f-datasets (e.g. \"01jun2026-31aug2026\" or \"2013q2\"), or \"latest\" (default)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "file": "SUMMARYPAGE.tsv",
  "note": "The whole SUMMARYPAGE.tsv member was read; rows is the first 5 of it.",
  "rows": [
   {
    "TABLEENTRYTOTAL": "91",
    "TABLEVALUETOTAL": "147088596",
    "ACCESSION_NUMBER": "0002134841-26-000139",
    "ISCONFIDENTIALOMITTED": "N",
    "OTHERINCLUDEDMANAGERSCOUNT": "0"
   }
  ],
  "table": "SUMMARYPAGE",
  "zip64": false,
  "source": "https://www.sec.gov/files/datastandardsinnovation/data/form-13f-data-sets/01jun2026-31aug2026_form13f.zip",
  "columns": [
   "ACCESSION_NUMBER",
   "OTHERINCLUDEDMANAGERSCOUNT",
   "TABLEENTRYTOTAL",
   "TABLEVALUETOTAL",
   "ISCONFIDENTIALOMITTED"
  ],
  "dataSet": {
   "id": "01jun2026-31aug2026",
   "to": "2026-08-31",
   "url": "https://www.sec.gov/files/datastandardsinnovation/data/form-13f-data-sets/01jun2026-31aug2026_form13f.zip",
   "from": "2026-06-01",
   "label": "2026 June July August 13F",
   "sizeMb": 96.05,
   "quarter": null
  },
  "members": [
   {
    "name": "SUMMARYPAGE.tsv",
    "bytes": 382912,
    "method": "deflate",
    "compressedBytes": 126238
   }
  ],
  "partial": false,
  "bytesRead": 192774,
  "readmeUrl": "https://www.sec.gov/files/form_13f_readme.pdf",
  "archiveBytes": 100719015,
  "rowsReturned": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/edgar-13f-dataset-head-1ad15673/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)