Deep research report - MAX (exhaustive)
POST /v1/research/maxThe exhaustive tier: up to a dozen sub-questions and grounded searches, the widest reranked source set, premium synthesis into a ~2,800-word cited report with a full source table. Send POST /v1/research/max with the required field query and pay $1.10 per call over x402 with USDC on an EVM chain. It returns a JSON object with report, sources, sub_questions and meta.
Our most thorough single-call research report. USDC or card (Stripe). Not cached.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | yes | The research question to investigate (<= 2000 chars). Also accepted as q, search, term, keyword, question. |
focus | array of string | no | Optional aspects to emphasize (<= 8). |
recency | string (one of: week, month, year, any) | no | Prefer sources from this window (default any). |
format | string (one of: markdown, json) | no | Response shape (default markdown report). |
Example request
curl -i -X POST https://agent402.tools/v1/research/max \
-H "Content-Type: application/json" \
-d '{"query":"What are the leading agentic-payment protocols in 2026 and how do they differ?","recency":"year"}'
Without payment this returns HTTP 402 Payment Required with the exact price for research-max; any x402 v2 or MPP client pays it and retries.
Example response
{
"report": "# Leading agentic-payment protocols (2026)\n\nThe field splits into stablecoin rails and card rails [1]…\n\n## Sources\n[1] … - https://…",
"sources": [
{
"n": 1,
"title": "…",
"url": "https://…",
"snippet": "…",
"rank": 0.94
}
],
"sub_questions": [
"What stablecoin agent-payment protocols exist?",
"…"
],
"meta": {
"tier": "research-max",
"searches_run": 3,
"sources_consulted": 14,
"sources_cited": 12,
"synthesis_model": "anthropic/claude-opus-5"
}
}
| Field | Type | Always present | In the example |
|---|---|---|---|
report | string | yes | # Leading agentic-payment protocols (2026) The field splits into stablecoin ... |
sources | array of objects | yes | 1 item in the example |
sub_questions | array of string | yes | 2 items in the example |
meta | object | yes | 5 fields: tier, searches_run, sources_consulted, sources_cited, synthesis_model |
From an MCP client
catalog.call {
"slug": "research-max",
"params": {
"query": "What are the leading agentic-payment protocols in 2026 and how do they differ?",
"recency": "year"
}
}
The hosted connector at https://agent402.tools/mcp needs a payment for research-max; the stdio package pays it from a wallet or from AGENT402_CREDITS_KEY. Local install: npx -y agent402-mcp.
Errors and behavior
queryis 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/research/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/research/max", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"query": "What are the leading agentic-payment protocols in 2026 and how do they differ?",
"recency": "year"
}),
});
Related tools
Market / competitor brief (grounded)
POST /v1/research/market-briefName a market, category or company and get one cited MARKET / COMPETITOR BRIEF: how the market is defined and sized, the…
Deep research report (grounded, cited)
POST /v1/researchHand over a whole research question and get one cited report back. The gateway plans sub-questions, runs multiple live w…
Deep research report - PRO (premium synthesis)
POST /v1/research/proThe deeper research tier: more sub-questions, more grounded searches, wider reranked source set, and a premium (Claude O…
Grounded chat (web search, OpenAI-compatible)
POST /v1/grounded/chat/completionsOpenAI-compatible chat completions GROUNDED in a live web search on every call: the gateway runs an Exa search (up to 5 …
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…
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 ang…