Company financials summary
GET /api/company-financialsKey financial metrics (Revenue, Net Income, Operating Income, Total Assets, Liabilities, Equity, EPS, Operating Cash Flow) for a US public company in one call. Send GET /api/company-financials with no required fields (2 optional) and pay $0.02 per call over x402 or MPP (there is no free tier). It returns a JSON object with ticker, cik, entityName, metrics and source.
Returns the latest annual and quarterly values from SEC XBRL filings. No XBRL knowledge needed - just pass a ticker.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
ticker | string | no | US stock ticker (alternative to cik) |
cik | string | no | SEC CIK number (alternative to ticker) |
Example request
curl -i "https://agent402.tools/api/company-financials?ticker=AAPL"
Without payment this returns HTTP 402 Payment Required with the exact price for company-financials; any x402 v2 or MPP client pays it and retries.
Example response
{
"ticker": "AAPL",
"cik": "0000320193",
"entityName": "Apple Inc.",
"metrics": [
{
"label": "Revenue",
"tag": "Revenues",
"latestAnnual": {
"value": 391035000000,
"period": "2024-09-28",
"form": "10-K"
},
"latestQuarterly": {
"value": 94930000000,
"period": "2025-03-29",
"form": "10-Q"
}
},
{
"label": "Net Income",
"tag": "NetIncomeLoss",
"latestAnnual": {
"value": 93736000000,
"period": "2024-09-28",
"form": "10-K"
},
"latestQuarterly": {
"value": 24780000000,
"period": "2025-03-29",
"form": "10-Q"
}
}
],
"source": "SEC EDGAR XBRL (public domain)"
}| Field | Type | Always present | In the example |
|---|---|---|---|
ticker | string | yes | AAPL |
cik | string | yes | 0000320193 |
entityName | string | yes | Apple Inc. |
metrics | array of objects | yes | 2 items in the example |
source | string | yes | SEC EDGAR XBRL (public domain) |
From an MCP client
catalog.call {
"slug": "company-financials",
"params": {
"ticker": "AAPL"
}
}The hosted connector at https://agent402.tools/mcp needs a payment for company-financials; the stdio package pays it from a wallet or from an AGENT402_CREDITS_KEY issued earlier. Local install: npx -y agent402-mcp@0.13.32.
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. 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. - A
POSTwith a JSON body to /api/company-financials is served as this GET, with the body as the input. - 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.02" }); // 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/company-financials?ticker=AAPL");Part of these workflows
Company financials summary is one step in these 3 skill packs, each sold as a single call:
- Earnings deep-dive - Everything you need before a company reports: the latest financials, recent SEC filings, the latest close, and fresh analyst news - in one pass.
- Financial analysis - Quick company snapshot: latest close, 9 key financial metrics (revenue through cash flow), and upcoming earnings - one call, one payment.
- Company dossier - Raw company data in one parallel call: latest close, financials, recent SEC filings, insider trades over the past 90 days and past-month web results on its news, each as its own tool's answer with no written report.
Related tools
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 XBRL company-facts (all tags)
All XBRL concepts reported by a company.
EDGAR XBRL frame (cross-company snapshot)
All US public companies that reported a given XBRL tag for a given period, in one call.
EDGAR Form 13F data set head (one table, bounded)
A bounded head of ONE table in a Form 13F data set, read with two byte-range requests against sec.gov (the archive's.
EDGAR Form 13F data sets (index)
The SEC's bulk Form 13F Data Sets: every quarterly (2013Q2-2023Q4) and rolling three-month (2024-) archive the SEC.
EDGAR 13F-HR holdings (institutional positions)
Top holdings from an institutional investment manager's most recent 13F-HR filing (managers >$100M AUM file quarterly).