Company due-diligence dossier - MAX (exhaustive)
POST /v1/dossier/maxThe exhaustive due-diligence tier: more filings, a full year of Form 4 insider activity, wider web research (up to 8 angles), the widest source set, and a ~2,800-word cited dossier with a full source table. Send POST /v1/dossier/max with the required field ticker and pay $1.10 per call over x402 with USDC on an EVM chain. It returns a JSON object with dossier, company, ticker, sources, tables and 1 more.
For a decision that warrants real diligence. USDC or card (Stripe). Not cached.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
ticker | string | yes | US stock ticker to investigate, e.g. AAPL. Also accepted as symbol, q, query, company. |
focus | array of string | no | Optional aspects to emphasize (<= 8), e.g. ["litigation", "debt"]. |
format | string (one of: markdown, json) | no | Response shape (default markdown dossier). |
Example request
curl -i -X POST https://agent402.tools/v1/dossier/max \
-H "Content-Type: application/json" \
-d '{"ticker":"AAPL","focus":["debt","litigation"]}'
Without payment this returns HTTP 402 Payment Required with the exact price for dossier-max; any x402 v2 or MPP client pays it and retries.
Example response
{
"dossier": "# Due-Diligence Dossier: Example Corp (EXMP)\n\n## Snapshot\nExample Corp trades at ... [1]\n\n## Sources\n[1] 10-K filed ... - https://www.sec.gov/...",
"company": "Example Corp",
"ticker": "EXMP",
"sources": [
{
"n": 1,
"title": "10-K filed 2025-11-01 - SEC EDGAR",
"url": "https://www.sec.gov/..."
}
],
"tables": [
{
"name": "financials",
"label": "SEC XBRL financials",
"columns": [
"Metric",
"Latest annual",
"Annual period",
"Most recent",
"Recent period"
],
"rows": [
[
"Total revenue",
"$1.2B",
"FY 2024 10-K filed 2025-11-01",
"$0.3B",
"2025-09-30 (10-Q)"
]
]
}
],
"meta": {
"tier": "dossier-max",
"company": "Example Corp",
"ticker": "EXMP",
"filings_10k": 1,
"filings_10q": 3,
"filings_8k": 5,
"insider_filings": 8,
"web_angles": 4,
"sources_cited": 18,
"synthesis_model": "anthropic/claude-opus-5"
}
}
| Field | Type | Always present | In the example |
|---|---|---|---|
dossier | string | yes | # Due-Diligence Dossier: Example Corp (EXMP) ## Snapshot Example Corp trades... |
company | string | yes | Example Corp |
ticker | string | yes | EXMP |
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, filings_10k, filings_10q, filings_8k |
From an MCP client
catalog.call {
"slug": "dossier-max",
"params": {
"ticker": "AAPL",
"focus": [
"debt",
"litigation"
]
}
}
The hosted connector at https://agent402.tools/mcp needs a payment for dossier-max; the stdio package pays it from a wallet or from AGENT402_CREDITS_KEY. Local install: npx -y agent402-mcp.
Errors and behavior
tickeris 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 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 (
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
GETorHEADto /v1/dossier/max 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?.(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/dossier/max", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"ticker": "AAPL",
"focus": [
"debt",
"litigation"
]
}),
});
Related tools
Company due-diligence dossier (grounded, cited)
POST /v1/dossierHand over a ticker and get one due-diligence dossier back. Pulls the company's SEC EDGAR filings (10-K / 10-Q / 8-K) and…
Ticker pack: dossier, insider flow and institutional holders
POST /v1/ticker-packOne ticker, one purchase, the full picture. Runs the company due-diligence dossier (SEC filings, XBRL financials, ground…
Fund portfolio report (13F, grounded)
POST /v1/fundHand over an institutional manager (a fund name like "Berkshire Hathaway", a ticker, or a SEC CIK) and get one cited rep…
Fund portfolio report - MAX (deep)
POST /v1/fund/maxThe deep tier: the full holdings table, wider quarter-over-quarter change analysis, more grounded web research, and a lo…
EDGAR company lookup (ticker → CIK)
GET /api/edgar-company-lookupResolve a US stock ticker (e.g. AAPL) to its SEC CIK number, the primitive every other EDGAR call needs. Returns ticker,…
SEC filing report (what the company just filed)
POST /v1/filing-reportName a US ticker and get one cited report on what the company just filed with the SEC: every filing in EDGAR's index for…