# AgentFilings

> Structured US SEC/EDGAR filing data for autonomous agents: filings index,
> XBRL-derived earnings summaries, and Form 4 insider transactions as clean JSON.
> Public-domain SEC data, pre-parsed and normalized. Pay per call with x402
> (USDC on Base). No account, no API key.

Base URL: https://api.agentfilings.com
OpenAPI: https://api.agentfilings.com/openapi.json
MCP (streamable HTTP): https://api.agentfilings.com/mcp

## Start here (free)

https://api.agentfilings.com/probe?ticker=AAPL

/probe tells you, before you spend anything: whether a ticker is covered, how much
data exists, how fresh it is, which endpoints will return something, and the exact
price of every endpoint. If a ticker is not covered, paid endpoints return 404 — so
check /probe rather than paying to find out.

## Endpoints

- GET /health — free. Liveness probe.
- GET /probe — free. Coverage, freshness timestamps, and per-endpoint pricing so agents can decide before paying.
- GET /filings/latest — $0.01. Latest filings for a ticker, optionally filtered by form type.
- GET /earnings/summary — $0.02. Structured earnings summary from XBRL company facts (no PDF parsing).
- GET /insiders — $0.01. Form 4 insider transactions for a ticker since a date.

Prices are per call, $0.01–$0.05.

## Responses

Every response is { data, meta }. meta carries the SEC source (accession number or
API), when the underlying filing was filed, when this service assembled the
response, and whether it was a cache hit. Errors carry a machine-readable code, a
message, and a hint.

## Payment

Paid endpoints answer HTTP 402 with payment requirements in the base64
PAYMENT-REQUIRED header (x402 v2 — not the body). Pay in USDC on Base mainnet, then
retry. Standard x402 clients handle this automatically.

## Data notes

- Source: SEC EDGAR, public domain. Refreshed twice daily.
- Earnings are derived from XBRL company facts, not from parsing documents.
  Restated figures resolve to the latest value, while each period keeps the fiscal
  year and quarter from its ORIGINAL filing, so prior-year comparatives embedded in
  later filings do not corrupt the labels.
- Every earnings period and insider transaction carries its source accession number.
- Coverage is US public companies filing with SEC EDGAR, and is still expanding.
  Do not assume a fixed index — call /probe?ticker= for the authoritative answer on
  any specific company. Tickers resolving to a post-reorganization shell with no XBRL
  history are deliberately excluded rather than reported as empty.