SEC filing report (what the company just filed)
POST /v1/filing-reportName a US ticker and get one cited, model-backed report on what the company just filed with the SEC: every filing in EDGAR's index for the window (8-K, 10-Q, 10-K, S-1, 424B4, DEF 14A and the rest, minus any form you exclude), the primary documents of the most consequential ones read in full and explained in plain language, and what changed versus the prior period where the filing itself says so, with a downloadable filings appendix. Send POST /v1/filing-report with no required fields (6 optional) and pay $0.85 per call over x402 with USDC on an EVM chain or MPP. It returns a JSON object with report, company, ticker, cik, sources and 2 more.
Not investment advice. Not cached. Takes up to 3 minutes to answer: send the paid call with "Prefer: respond-async" to get a job link at once and collect the answer from it (on x402 the payment settles only on a delivered result), or with "Prefer: wait=180" and keep the connection open for at least 210 seconds, because a client that disconnects first loses the answer. A paid call with neither header is answered 400 before any payment is taken.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
ticker | string | no | US stock ticker, e.g. AAPL (or pass cik). |
cik | string | no | SEC CIK of the company (alternative to ticker). |
days | number | no | Lookback window in days, 1-365 (default 30). |
forms | string | no | Optional allowlist of form types, comma-separated or an array, e.g. "8-K,10-Q". Omit for every form. |
exclude | string | no | Form types to ignore, comma-separated or an array, e.g. "4,3,5" to drop insider ownership forms. |
focus | string | no | Optional accession numbers to read in full first, comma-separated or an array (e.g. the filing that just landed). |
Example request
curl -i -X POST https://agent402.tools/v1/filing-report \
-H "Content-Type: application/json" \
-d '{"ticker":"AAPL","days":30}'Without payment this returns HTTP 402 Payment Required with the exact price for filing-report; any x402 v2 or MPP client pays it and retries.
Watch a call get paid
POST /v1/filing-report$0.85 USDCPAYMENT-SIGNATUREon 11 chains200 OKAgent402-ReceiptEd25519Example response
{
"report": "# SEC Filing Report: Example Corp (EXMP)\n\n**Last 30 days** · 4 filings (8-K x2, 10-Q x1, 4 x1) · 3 primary documents read in full\n\n## Snapshot\n...\n\n## Sources\n[1] 8-K filed 2026-08-20 - Example Corp - SEC EDGAR - https://www.sec.gov/Archives/edgar/data/42/000000000000000000/ex8k.htm",
"company": "Example Corp",
"ticker": "EXMP",
"cik": "0000000042",
"sources": [
{
"n": 1,
"title": "8-K filed 2026-08-20 - Example Corp - SEC EDGAR",
"url": "https://www.sec.gov/Archives/edgar/data/42/000000000000000000/ex8k.htm"
}
],
"tables": [
{
"name": "filings",
"label": "SEC filings in the window",
"columns": [
"Filed",
"Form",
"Form meaning",
"Period",
"Description",
"Accession",
"Read in full",
"URL"
],
"rows": [
[
"2026-08-20",
"8-K",
"current report (material event)",
"2026-08-19",
"8-K",
"0000000042-26-000011",
"yes",
"https://www.sec.gov/Archives/edgar/data/42/000000000000000000/ex8k.htm"
]
]
}
],
"meta": {
"tier": "filing-report",
"company": "Example Corp",
"ticker": "EXMP",
"cik": "0000000042",
"window_days": 30,
"filings": 4,
"documents_read": 3,
"sources_cited": 5,
"synthesis_model": "anthropic/claude-opus-5",
"disclaimer": "SEC filings as filed with the Commission (public domain); summary of public documents, not investment advice."
}
}| Field | Type | Always present | In the example |
|---|---|---|---|
report | string | yes | # SEC Filing Report: Example Corp (EXMP) **Last 30 days** · 4 filings (8-K x... |
company | string | yes | Example Corp |
ticker | string | yes | EXMP |
cik | string | yes | 0000000042 |
sources | array of objects | yes | 1 item in the example |
tables | array of objects | yes | 1 item in the example |
meta | object | yes | 10 fields: tier, company, ticker, cik, window_days, filings and 4 more |
From an MCP client
catalog.call {
"slug": "filing-report",
"params": {
"ticker": "AAPL",
"days": 30
}
}The hosted connector at https://agent402.tools/mcp needs a payment for filing-report; the stdio package pays it from a wallet or from an AGENT402_CREDITS_KEY issued earlier. Local install: npx -y agent402-mcp@0.14.1.
Errors and behavior
- Every field is optional. An input the tool rejects returns an HTTP 4xx whose body carries
error,tool,expected,requiredandexample. - A paid call that ends in any status of 400 or above is not charged over x402, MPP or a prepaid credits key: settlement runs after the tool and only on a successful response.
- Wallet-only: this tool runs a model, so it has no proof-of-work tier. A prepaid card-credits key issued earlier (
Authorization: Bearer a402_...) also pays it. - Model-backed: the answer is generated by a model, so the same input can produce a different result.
- Long-running: payment settles after the work finishes, so x402 is offered on EVM chains only and MPP on Base, Celo or card; Tempo is not offered.
- Usually answers in about 90 seconds and takes up to 180 seconds. Send the paid call with
Prefer: respond-asyncto get202and a job link at once, then pollGET /api/jobs/{id}for its stage, progress and ETA until it has the answer; payment still settles only when the answer is ready, except a Tempo transfer sent before the call, which is repaid after on-chain proof if the run fails. To wait on the connection instead, sendPrefer: wait=180and keep it open that long. A paid call with neither header is answered400before any payment is taken. - A
GETorHEADto /v1/filing-report returns the same 402 quote, so the price can be read without a body. - An
Idempotency-Keyheader makes a retried paid call replay the first 200 instead of charging again (an answer larger than 1 MB and a streamed response are not replayed).
Paid call (JavaScript agent)
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = new x402Client();
client.setSpendControls?.({ maxAmountPerPayment: "$0.85" }); // refuse any quote above this tool's price
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);
const res = await payFetch("https://agent402.tools/v1/filing-report", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ticker": "AAPL",
"days": 30
}),
});Related tools
Insider flow report (Form 4 transactions)
Name a US ticker and get one cited, model-backed insider-flow report: every Form 4 against the company in the window.
IPO pipeline digest (S-1 + 424B4)
A deterministic digest of the IPO pipeline for a window: every 424B4 final prospectus and every S-1/F-1 registration.
EDGAR recent filings
Recent SEC filings for a company by ticker or CIK, newest first.
EDGAR full-text search
General-purpose full-text search across every SEC filing since 2001.
LinkedIn article, ready to publish (research + copy + sized images)
Hand over a topic and get a publish-ready LinkedIn article back: grounded web research with cited sources, three.
FDA recall report (drug, food, device)
Name a drug, food, ingredient, brand or medical device and get one cited, model-backed FDA recall report: every matching.