# Filings Oracle (WickedAPI)

> Real-time SEC EDGAR alerts for agents. 8-K material events classified by item and category, Form 4 insider trades parsed to one row per transaction, and Schedule 13D/13G, 10-K and 10-Q filings, ingested within about a minute of SEC acceptance. Every row traces to a real SEC filing - nothing is inferred or fabricated.

## Auth - two ways, both work on every paid endpoint

1. `x-api-key: YOUR_KEY` header.
2. x402 pay-per-call - call with no key, receive HTTP 402 with a USDC price ($0.002/request on base), pay, get 200 + data. Listed on the x402 Bazaar.

## Free endpoints

- [GET /v1/freshness](https://filings.wickedapi.com/v1/freshness): Proof of real-time: seconds since the last successful SEC poll, age of the newest filing, median and p95 ingest lag (from SEC acceptance time) over the last 200 live filings, last successful poll per form type, and rows stored
- [GET /v1/latest-preview](https://filings.wickedapi.com/v1/latest-preview): The 10 most recent filings across all form types (form, company, ticker, filed_at only)

## Paid endpoints

- [GET /v1/filings](https://filings.wickedapi.com/v1/filings): Structured SEC filings feed (8-K, Form 4, Schedule 13D/13G, 10-K, 10-Q), ingested within about a minute of SEC acceptance
- [GET /v1/8k-events](https://filings.wickedapi.com/v1/8k-events): 8-K material-event alerts classified into categories an agent can act on: earnings, exec_change, material_agreement, acquisition_disposition, bankruptcy, delisting, cybersecurity, auditor_or_restatement, control_change, financing, restructuring_impairment, shareholder_vote, governance, reg_fd, other_events
- [GET /v1/insider-trades](https://filings.wickedapi.com/v1/insider-trades): Form 4 insider transactions parsed to one row per trade: insider, role and title, security, code (P purchase, S sale, A grant ...), shares, price, dollar value, shares owned after, direct/indirect, and whether it was under a 10b5-1 plan
- [GET /v1/insider-summary](https://filings.wickedapi.com/v1/insider-summary): Insider activity rollup for one ticker over a window: open-market buy and sell counts and dollar totals, net flow, distinct buyers and sellers, a cluster-buying flag (three or more insiders buying), and the largest trades
- [GET /v1/filing](https://filings.wickedapi.com/v1/filing): One filing by accession number, with its parsed items or insider transactions and the SEC document link

## Real-time pattern

Every list response carries `meta.cursor`. Pass it back as `since=<cursor>&wait=25` to long-poll: the request returns the instant a new filing is stored (or empty after 25s), so an agent gets push-like latency over plain HTTP, paying only for calls made.

## Reference

- [OpenAPI spec](https://filings.wickedapi.com/openapi.json)
- [Interactive docs](https://filings.wickedapi.com/docs)
- [Service catalog](https://filings.wickedapi.com/v1/status)
- [Agent Card](https://filings.wickedapi.com/.well-known/agent.json)