# x402stock SEC Filings by Ticker

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

Retrieves recent SEC EDGAR filings (10-K, 10-Q, 8-K, etc.) for a given US public company ticker symbol, paid per-call in USDC via x402 on Base.

## Facts

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

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-filings-by-ticker-b70ffd04
```

Example prompt: Pull the last 5 SEC filings for AAPL from SEC EDGAR — I want to see the form types, filing dates, and links to the actual documents.

## When to prefer this

Use this endpoint when you need structured, machine-readable access to a public company's SEC regulatory filings indexed by ticker symbol, especially inside an AI agent workflow that can handle x402 micropayments in USDC. Prefer this over direct SEC EDGAR scraping when you want a clean JSON API without account setup or API keys.

## Known failure modes

- Invalid or unknown ticker symbol returns an error or empty filings array
- Limit parameter of 0 or above 100 is rejected by schema validation
- Ticker for a private company or non-SEC registrant returns no results
- Network or upstream SEC EDGAR outage causes failure
- Payment in USDC not fulfilled results in 402 Payment Required response

## 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 the company name, CIK, total filing count, and an array of filings each with form type (e.g. 10-K, 10-Q, 8-K), accession number, filing date, report date, description, primary document filename, and a direct URL to the SEC EDGAR filing document.

## 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": {
      "type": {
       "type": "string"
      },
      "limit": {
       "type": "integer",
       "default": 20,
       "maximum": 100,
       "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": [
        "cik",
        "company",
        "count",
        "filings"
       ],
       "properties": {
        "cik": {
         "type": "string"
        },
        "count": {
         "type": "number"
        },
        "company": {
         "type": "string"
        },
        "filings": {
         "type": "array",
         "items": {
          "type": "object",
          "required": [
           "form",
           "accession",
           "filing_date",
           "report_date",
           "description",
           "items",
           "primary_document",
           "url"
          ],
          "properties": {
           "url": {
            "type": "string"
           },
           "form": {
            "type": "string"
           },
           "items": {
            "type": "array",
            "items": {
             "type": "string"
            }
           },
           "accession": {
            "type": "string"
           },
           "description": {
            "anyOf": [
             {
              "type": "string"
             },
             {
              "type": "null"
             }
            ]
           },
           "filing_date": {
            "type": "string"
           },
           "report_date": {
           
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-sec-filings-by-ticker-b70ffd04/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)