# SEC EDGAR Filings Delta Feed (x402)

> SEC EDGAR Filings Delta Feed (x402) is a paid API for AI agents from x402.donnyautomation.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Returns a delta of SEC EDGAR filings for a given company since a specified date, filtered by form type, via pay-per-call x402/USDC.

## Facts

- Endpoint: GET https://x402.donnyautomation.com/edgar/filings
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-edgar-filings-delta-feed-x402-7fe6c9af
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3mLjTtlRArXIAHDSnP6RD

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 sec-edgar-filings-delta-feed-x402-7fe6c9af
```

Example prompt: Pull all SEC EDGAR filings for Apple (ticker AAPL) since 2026-01-01, filtering for 8-K forms only, and return up to 50 results.

## When to prefer this

Use this endpoint when you need a structured, machine-readable delta feed of SEC EDGAR filings for a specific public company, especially for monitoring new disclosures since a known date. Prefer it over scraping SEC.gov directly because it handles CIK resolution, form filtering, pagination cursors, and live data retrieval in one call. Ideal for compliance monitoring, financial research agents, and event-driven trading workflows that need to detect new 8-K, 10-K, 10-Q, or amendment filings. The pay-per-call x402 model makes it suitable for on-demand agent use without subscription overhead.

## Known failure modes

- Missing required 'since' date parameter returns a 400 error
- Unknown ticker symbol that cannot be resolved via SEC company_tickers.json returns an error or empty result
- Requesting more than 200 results (limit cap) may be rejected
- Payment failure via x402/USDC results in 402 Payment Required and no data returned
- Network or EDGAR upstream unavailability may return a 5xx error
- Invalid date format for 'since' (non-ISO YYYY-MM-DD) causes a parse error

## How this service works

Every SEC filing by one issuer SINCE a cursor - a delta, not a dump. Requires ?since=YYYY-MM-DD AND ?ticker= or ?cik= (cik wins if both). Optional ?forms=10-K,8-K (also matches /A), ?limit=1..200. Errors: 400 missing_since|missing_issuer|bad_since|bad_ticker|bad_cik|bad_limit, 404 unknown_ticker|unknown_cik, 502 edgar_unavailable, 503 rate_limited_locally. AN EMPTY DELTA IS CHARGED: nothing-changed is the answer you bought. 8-K with decoded items: /edgar/events. Ownership: /edgar/insiders.

## Output

A JSON object containing issuer metadata (CIK, name, ticker, exchanges, SIC description), a list of matching filings each with form type, filing date, report date, accession number, filing index URL, and primary document URL, plus pagination metadata: matched count, truncated flag, nextSince cursor (inclusive), and coverage range. The 'changed' flag indicates whether any new filings appeared since the cursor date.

## 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",
     "required": [
      "ticker",
      "since"
     ],
     "properties": {
      "cik": {
       "type": "string",
       "description": "SEC Central Index Key, 1 to 10 digits, zero padding optional (e.g. 320193 or 0000320193). Alternative to ticker; supplying either one is enough."
      },
      "forms": {
       "type": "string",
       "description": "Comma separated form filter, e.g. 10-K,10-Q,8-K. A form also matches its /A amendment; 8-K/A alone matches only amendments."
      },
      "limit": {
       "type": "string",
       "description": "Maximum filings returned, 1 to 200 (default 50). The response reports matched and truncated so a cut-off delta is never mistaken for a complete one."
      },
      "since": {
       "type": "string",
       "description": "ISO date YYYY-MM-DD. INCLUSIVE cursor: filings on this date are returned. Required — this endpoint returns a delta, not a dump."
      },
      "ticker": {
       "type": "string",
       "description": "Exchange ticker, e.g. AAPL. Resolved through SEC company_tickers.json. Send cik instead when you have it: cik is EDGAR identity, ticker is a convenience. If both are sent, cik wins."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "since": "2026-01-01",
  "issuer": {
   "cik": "0000320193",
   "name": "Apple Inc.",
   "ticker": "AAPL",
   "exchanges": [
    "Nasdaq"
   ],
   "sicDescription": "Electronic Computers"
  },
  "changed": true,
  "filings": [
   {
    "form": "8-K",
    "items": "2.02,9.01",
    "filingDate": "2026-07-30",
    "reportDate": "2026-07-30",
    "filingIndexUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000018/0000320193-26-000018-index.htm",
    "accessionNumber": "0000320193-26-000018",
    "acceptanceDateTime": "2026-07-30T20:30:28.000Z",
    "primaryDocumentUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000018/aapl-20260730.htm"
   }
  ],
  "matched": 1,
  "coverage": {
   "to": "2026-08-27",
   "from": "2015-06-04",
   "complete": true
  },
  "endpoint": "/edgar/filings",
  "nextSince": "2026-07-30",
  "truncated": false,
  "attribution": "Source: U.S. Securities and Exchange Commission EDGAR. US Government public-domain records, read live at call time.",
  "cursorSemantics": "nextSince is INCLUSIVE — the next call re-returns that day's filings. Dedupe on accessionNumber."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sec-edgar-filings-delta-feed-x402-7fe6c9af/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.donnyautomation.com](https://www.zero.xyz/host/x402.donnyautomation.com/llms.txt)