# ioswarm SEC Filings Feed

> ioswarm SEC Filings Feed is a paid API for AI agents from ioswarm.io, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-11).

Returns parsed, ticker-tagged SEC filings including 8-K events, Form 4 insider trades, insider cluster buys, activist 13D stakes, and new IPO filings (S-1/F-1), rebuilt every 30 minutes.

## Facts

- Endpoint: POST https://ioswarm.io/api/v1/feeds/filings?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ioswarm-sec-filings-feed-994bbcb8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hDNS9gmC2CJoL5Lx46SIo

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 ioswarm-sec-filings-feed-994bbcb8 -d '<json body>'
```

Example prompt: Pull the latest insider trades and 8-K filings for NVDA from today's SEC feed, up to 50 results each.

## When to prefer this

Choose this endpoint when you need structured, parsed SEC filing data with plain-language descriptions rather than raw EDGAR HTML/XML. Particularly valuable for insider trade monitoring, activist stake detection, IPO pipeline tracking, or flagging material 8-K events by item code. Prefer over raw EDGAR APIs when you need ticker-tagged, deduplicated, human-readable output refreshed every 30 minutes without requiring an account.

## Known failure modes

- Invalid ticker returns empty results rather than an error
- Unsupported section enum value returns validation error
- Date outside available range returns empty or stale data
- Malformed RFC 3339 date string for 'at' parameter causes 400 error
- Limit exceeding 200 returns validation error
- No filings available for a very recent timestamp window returns empty sections

## How this service works

New SEC filings, parsed: 8-K events with item codes in plain words, Form 4 insider trades (shares, price, dollar value, role), insider cluster buys, activist 13D stakes and new S-1/F-1 IPO filings. Tickers attached; filter by ticker. Rebuilt every 30 minutes. $0.02 per call, no account. Free 24h-delayed sample: GET https://ioswarm.io/api/v1/feeds/filings/sample.

## Output

A structured feed broken into sections (8-K, insider, insider_clusters, 13D, ipo), each containing parsed filing records with tickers, item codes in plain English, insider names and roles, share counts, trade prices, dollar values, and filing timestamps. Data is rebuilt every 30 minutes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "maxLength": 80,
   "description": "Text filter."
  },
  "at": {
   "type": "string",
   "description": "Past edition: RFC 3339 or YYYY-MM-DD."
  },
  "date": {
   "type": "string",
   "description": "YYYY-MM-DD (UTC)."
  },
  "limit": {
   "type": "integer",
   "maximum": 200,
   "minimum": 1,
   "description": "Items per section."
  },
  "ticker": {
   "type": "string",
   "description": "Ticker/symbol filter."
  },
  "section": {
   "enum": [
    "8-K",
    "insider",
    "insider_clusters",
    "13D",
    "ipo"
   ],
   "type": "string",
   "description": "One section (default: all)."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ioswarm-sec-filings-feed-994bbcb8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ioswarm.io](https://www.zero.xyz/host/ioswarm.io/llms.txt)
