SEC filing report (what the company just filed)

Name a US ticker and get one cited 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. It returns a JSON object with report, company, ticker, cik, sources and 2 more.

Not investment advice. Not cached.

Category: LLM gateway · Tags: sec edgar filings 8-k 10-q 10-k s-1 proxy

TRY IN PLAYGROUND →

Parameters

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.

Example 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."
  }
}

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 AGENT402_CREDITS_KEY. Local install: npx -y agent402-mcp.

Errors and behavior

• Every field is optional. An input the tool rejects returns an HTTP 4xx whose body carries error, tool, expected, required and example.
• A paid call that ends in any status of 400 or above is not charged over x402, MPP or a prepaid credits key: settlement is cancelled when the tool fails.
• 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 different wording.
• Long-running: payment settles after the work finishes, so only EVM exact payments are offered.
• A GET or HEAD to /v1/filing-report returns the same 402 quote, so the price can be read without a body.
• An Idempotency-Key header 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?.(false); // keep your own spending ceiling in code
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