# x402stock Ticker Dossier

> x402stock Ticker Dossier is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-08).

Returns a comprehensive SEC filing dossier for a US stock ticker, including Form 3 holdings, Form 4 insider trades, SEC filings list, and material events

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/dossier/%7Bticker%7D
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-08
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-ticker-dossier-0929e38b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dCzhN8rymgk7N7wCKtMm9

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-ticker-dossier-0929e38b
```

Example prompt: Pull the full SEC dossier for AAPL — I want to see recent insider trades, Form 3 holdings, and any material filings.

## When to prefer this

Use this endpoint when you need a bundled SEC regulatory dossier for a single US stock ticker — combining insider holdings, insider trades, and filings in one call. Prefer this over individual SEC EDGAR queries when you want a pre-aggregated, agent-ready summary without managing multiple API requests or API keys.

## Known failure modes

- Unknown or invalid ticker returns an error or empty data
- Delisted tickers may return no filings
- Rate limiting or payment failure returns 402 Payment Required
- Partial data if some SEC EDGAR sections are unavailable (section status reflects this)
- Very recent filings may not yet be indexed

## 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

A JSON object containing: SEC Form 3 insider holdings (shares held, security type, director/officer status), Form 4 insider transaction history with net buying/selling signal, a list of recent SEC filings (10-K, 8-K, etc.) with URLs and dates, material event summaries, and section-level status indicators — all timestamped and sourced from SEC EDGAR.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-06-04T12:00:00.000Z",
  "form_3": {
   "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"
  },
  "source": "x402stock",
  "ticker": "AAPL",
  "filings": {
   "data": {
    "cik": "0000320193",
    "count": 1,
    "company": "Apple Inc.",
    "filings": [
     {
      "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000123/aapl-20250927.htm",
      "form": "10-K",
      "items": [],
      "accession": "0000320193-25-000123",
      "description": "Form 10-K",
      "filing_date": "2025-11-01",
      "report_date": "2025-09-27",
      "primary_document": "aapl-20250927.htm"
     }
    ]
   },
   "as_of": "2025-11-01T00:00:00.000Z",
   "source": "sec_edgar",
   "ticker": "AAPL"
  },
  "sections": {
   "form_3": "ok",
   "filings": "ok",
   "insider_trades": "ok",
   "material_events": "ok"
  },
  "insider_trades": {
   "data": {
    "summary": {
     "buys": 0,
     "sells": 1,
     "signal": "net_selling",
     "net_shares": -50000,
     "shares_sold": 50000,
     "shares_bought": 0
    },
    "transactions": [
     {
      "url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126023363/form4.xml",
      "code": "S",
      "shares": 50000,
      "security": "Common Stock",
      "accession": "0001140361-26-023363",
      "code_label": "Open-market or private sale",
      "is_officer": true,
      "owner_name": "WILLIAMS JEFFREY E",
      "filing_date": "2026-05-29",
      "is_director": false,
      "is_derivative": false,
      "officer_title": "COO",
      "price_per_share": 311.02,
      "transaction_date": "2026-05-27",
      "acquired_disposed": "D",
      "shares_owned_after": 3764576,
      "is_ten_percent_owner": false
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-ticker-dossier-0929e38b/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)
