SEC filings brief (peer set)
POST /api/filings-briefOne 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.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
tickers | array of string | yes | 1 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
POST /api/filings-brieffrom $0.021 USDCPAYMENT-SIGNATUREon 14 chains200 OKAgent402-ReceiptEd25519Example 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)"
}| Field | Type | Always present | In the example |
|---|---|---|---|
product | string | yes | filings-brief |
generatedAt | string | yes | 2026-11-18T23:40:00.000Z |
companies | number | yes | 5 |
peers | object | yes | 3 fields: byRevenue, byNetMargin, flagged |
rows | array of objects | yes | 1 item in the example |
method | string | yes | Values are the latest annual and quarterly XBRL facts as filed; ratios divide... |
pricing | object | yes | 4 fields: units, unitPartsUsd, priceUsd, rule |
source | string | yes | computed 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
tickersis required. An input the tool rejects returns an HTTP 4xx whose body carrieserror,tool,expected,requiredandexample, so the caller can correct it.- 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. The exception is a Tempo push credential, a transfer the buyer sent before the call: it settles before the tool runs, so if the tool then fails the payment is recorded as a refund owed to the paying wallet.
- Wallet-only: this tool reaches the network or stored state, so it has no proof-of-work tier. A prepaid card-credits key issued earlier (
Authorization: Bearer a402_...) also pays it. - Priced per request: the 402 quotes this body, between $0.021 and $0.828.
- A
GETorHEADto /api/filings-brief 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 is 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.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
Recent SEC filings for a company by ticker or CIK, newest first.
EDGAR XBRL company-concept (one tag, full history)
Full reported history of a single XBRL concept for one company (e.g. quarterly Revenues for Apple).
EDGAR full-text search
General-purpose full-text search across every SEC filing since 2001.
Company financials summary
Key financial metrics (Revenue, Net Income, Operating Income, Total Assets, Liabilities, Equity, EPS, Operating Cash.
EDGAR XBRL company-facts (all tags)
All XBRL concepts reported by a company.
EDGAR company lookup (ticker → CIK)
Resolve a US stock ticker (e.g.