# x402stock SEC Form 3 Insider Holdings API

> x402stock SEC Form 3 Insider Holdings API is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Retrieves SEC Form 3 insider ownership filings for a given stock ticker, including director and officer holdings

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/form-3/%7Bticker%7D
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-sec-form-3-insider-holdings-api-cfde8b8d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9KPsi8Boaib-J3IrPHBF4

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-sec-form-3-insider-holdings-api-cfde8b8d
```

Example prompt: Pull the most recent 10 SEC Form 3 insider ownership filings for AAPL — I want to see who reported initial beneficial ownership, how many shares they hold, and whether they're a director or officer.

## When to prefer this

Use this endpoint when you need SEC Form 3 initial statements of beneficial ownership for corporate insiders (directors, officers, 10% owners) of a specific US public company. Prefer this over general insider trading endpoints when you specifically need initial ownership disclosures rather than ongoing transaction reports (Form 4) or annual ownership summaries (Form 5). Ideal for corporate governance research, compliance checks, or building insider ownership profiles without needing an API key or subscription.

## Known failure modes

- Invalid or unknown ticker symbol returns empty data or 404
- limit parameter out of range (must be 1–25) returns validation error
- SEC EDGAR data delay may cause recently filed Form 3s to not appear immediately
- Payment failure via x402/USDC results in 402 response and no data returned
- Ticker with no Form 3 filings returns empty holdings array

## 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 the ticker, data source (SEC EDGAR), as-of timestamp, total filing count, and an array of individual Form 3 holdings. Each holding includes the owner's name, role (director/officer/10% owner), filing date, accession number, SEC filing URL, security type, number of shares, direct or indirect ownership flag, and for derivative securities: exercise price, exercise date, expiration date, underlying security name, and underlying share count.

## 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": 5,
       "maximum": 25,
       "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": [
      "ticker",
      "data",
      "source",
      "as_of"
     ],
     "properties": {
      "data": {
       "type": "object",
       "required": [
        "filings_parsed",
        "holding_count",
        "holdings"
       ],
       "properties": {
        "holdings": {
         "type": "array",
         "items": {
          "type": "object",
          "required": [
           "owner_name",
           "is_director",
           "is_officer",
           "officer_title",
           "is_ten_percent_owner",
           "filing_date",
           "accession",
           "url",
           "security",
           "shares",
           "direct_or_indirect",
           "nature_of_ownership",
           "is_derivative",
           "exercise_price",
           "exercise_date",
           "expiration_date",
           "underlying_security",
           "underlying_shares"
          ],
          "properties": {
           "url": {
            "type": "string"
           },
           "shares": {
            "anyOf": [
             {
              "type": "number"
             },
             {
              "type": "null"
             }
            ]
           },
           "security": {
            "anyOf": [
             {
              "type": "string"
             },
             {
              "type": "null"
             }
            ]
           },
           "accession": {
            "type": "string"
           },
           "is_officer
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "holdings": [
    {
     "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126021000/form3.xml",
     "shares": 1200,
     "security": "Common Stock",
     "accession": "0001140361-26-021000",
     "is_officer": false,
     "owner_name": "DOE JANE",
     "filing_date": "2026-05-20",
     "is_director": true,
     "exercise_date": null,
     "is_derivative": false,
     "officer_title": null,
     "exercise_price": null,
     "expiration_date": null,
     "underlying_shares": null,
     "direct_or_indirect": "D",
     "nature_of_ownership": null,
     "underlying_security": null,
     "is_ten_percent_owner": false
    }
   ],
   "holding_count": 1,
   "filings_parsed": 1
  },
  "as_of": "2026-05-20T00:00:00.000Z",
  "source": "sec_edgar",
  "ticker": "AAPL"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-sec-form-3-insider-holdings-api-cfde8b8d/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)
