Skip to content

SEC filings brief (peer set)

quoted per request from $0.021USDC via x402POST /api/filings-brief

One SEC EDGAR brief for up to 40 US public companies in one call: per company the latest annual and quarterly financials as filed (revenue, net and operating income, assets, liabilities, equity, EPS, operating cash flow) with margins and leverage computed, filing activity (latest 10-K and 10-Q, days since the latest periodic report, 8-K count over 90 days, the newest filings with links) and Form 4 filing activity over 90 days; flags for net loss, negative equity, high leverage, a missing periodic report, busy insider filing and frequent 8-Ks, with the set ranked by revenue and net margin. Send POST /api/filings-brief with the required field tickers and pay quoted per request from $0.021 over x402 or MPP (there is no free tier). It returns a JSON object with product, generatedAt, companies, peers, rows and 3 more.

Priced per company: the three EDGAR tools it runs (company-financials, edgar-filings, edgar-insider-trades) less 10%, $0.021 a company, quoted in the 402 for the tickers you send. Deterministic code over public-domain SEC data, no model; facts, not investment advice.

Category: Live public dataTags: sec edgar filings financials peers 10-k insider bundle

Try in playground →

Parameters

NameTypeRequiredDescription
tickersarray of stringyes1 to 40 US stock tickers (a comma-separated string also works)

Example request

curl -i -X POST https://agent402.tools/api/filings-brief \
  -H "Content-Type: application/json" \
  -d '{"tickers":["MSFT","AAPL","GOOGL","AMZN","META"]}'

Without payment this returns HTTP 402 Payment Required with the exact price for filings-brief; any x402 v2 or MPP client pays it and retries.

Watch a call get paid

RequestPOST /api/filings-brief
402from $0.021 USDC
SignPAYMENT-SIGNATURE
Settleon 14 chains
Answer200 OK
ReceiptAgent402-ReceiptEd25519

Example response

{
  "product": "filings-brief",
  "generatedAt": "2026-11-18T23:40:00.000Z",
  "companies": 5,
  "peers": {
    "byRevenue": [
      {
        "rank": 1,
        "ticker": "AMZN",
        "value": 716924000000
      },
      {
        "rank": 2,
        "ticker": "AAPL",
        "value": 416161000000
      }
    ],
    "byNetMargin": [
      {
        "rank": 1,
        "ticker": "MSFT",
        "value": 0.4031
      }
    ],
    "flagged": [
      {
        "ticker": "META",
        "flags": [
          "busyInsiderFiling"
        ]
      }
    ]
  },
  "rows": [
    {
      "ticker": "MSFT",
      "cik": "0000789019",
      "name": "MICROSOFT CORP",
      "industry": "Services-Prepackaged Software",
      "exchanges": [
        "Nasdaq"
      ],
      "flags": [],
      "financials": {
        "annual": {
          "revenue": 331839000000,
          "netIncome": 133749000000,
          "operatingIncome": 155237000000,
          "totalAssets": 758376000000,
          "totalLiabilities": 315989000000,
          "stockholdersEquity": 442387000000,
          "epsBasic": 18,
          "operatingCashFlow": 151893000000,
          "period": "2026-06-30"
        },
        "quarterly": {
          "revenue": 92279000000,
          "netIncome": 36629000000,
          "period": "2026-09-30"
        },
        "ratios": {
          "netMargin": 0.4031,
          "operatingMargin": 0.4678,
          "liabilitiesToAssets": 0.4167,
          "equityToAssets": 0.5833
        }
      },
      "filingActivity": {
        "last10K": "2026-07-29",
        "last10Q": "2026-10-28",
        "daysSinceLatestPeriodicReport": 21,
        "eightKLast90Days": 4,
        "recentFilings": [
          {
            "form": "4",
            "filingDate": "2026-11-16",
            "url": "https://www.sec.gov/Archives/edgar/data/789019/000078901926000236/xslF345X06/form4.xml"
          }
        ],
        "recentFilingsPartial": {
          "returned": 5,
          "matched": 200,
          "complete": false,
          "truncated": true
        },
        "filingsRead": 200,
        "oldestFilingRead": "2026-03-02"
      },
      "insiderActivity": {
        "windowDays": 90,
        "form4Filings": 45,
        "filers": [
          "Coleman Amy  (CIK 0002062356)"
        ],
        "note": "Form 4 filings counted, not shares or direction"
      }
    }
  ],
  "method": "Values are the latest annual and quarterly XBRL facts as filed; ratios divide annual values.",
  "pricing": {
    "units": 5,
    "unitPartsUsd": 0.023,
    "priceUsd": 0.104,
    "rule": "the sum of each unit's tools (company-financials, edgar-filings, edgar-insider-trades) times the units, less 10%, rounded up to $0.001"
  },
  "source": "computed from SEC EDGAR (data.sec.gov submissions and XBRL company facts, efts.sec.gov full-text search; public domain)"
}
FieldTypeAlways presentIn the example
productstringyesfilings-brief
generatedAtstringyes2026-11-18T23:40:00.000Z
companiesnumberyes5
peersobjectyes3 fields: byRevenue, byNetMargin, flagged
rowsarray of objectsyes1 item in the example
methodstringyesValues are the latest annual and quarterly XBRL facts as filed; ratios divide...
pricingobjectyes4 fields: units, unitPartsUsd, priceUsd, rule
sourcestringyescomputed from SEC EDGAR (data.sec.gov submissions and XBRL company facts, eft...

From an MCP client

catalog.call {
  "slug": "filings-brief",
  "params": {
    "tickers": [
      "MSFT",
      "AAPL",
      "GOOGL",
      "AMZN",
      "META"
    ]
  }
}

The hosted connector at https://agent402.tools/mcp needs a payment for filings-brief; the stdio package pays it from a wallet or from an AGENT402_CREDITS_KEY issued earlier. Local install: npx -y agent402-mcp@0.14.0.

Errors and behavior

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.828" }); // 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/api/filings-brief", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "tickers": [
      "MSFT",
      "AAPL",
      "GOOGL",
      "AMZN",
      "META"
    ]
  }),
});

Related tools

EDGAR recent filings

$0.003GET /api/edgar-filings

Recent SEC filings for a company by ticker or CIK, newest first.

EDGAR XBRL company-concept (one tag, full history)

$0.005GET /api/edgar-company-concept

Full reported history of a single XBRL concept for one company (e.g. quarterly Revenues for Apple).

EDGAR full-text search

$0.005GET /api/edgar-search

General-purpose full-text search across every SEC filing since 2001.

Company financials summary

$0.015GET /api/company-financials

Key financial metrics (Revenue, Net Income, Operating Income, Total Assets, Liabilities, Equity, EPS, Operating Cash.

EDGAR XBRL company-facts (all tags)

$0.005GET /api/edgar-company-facts

All XBRL concepts reported by a company.

EDGAR company lookup (ticker → CIK)

$0.001GET /api/edgar-company-lookup

Resolve a US stock ticker (e.g.