Audit report (one wallet's paid history, signed)
POST /api/audit-reportAn audit report of your own wallet's paid history here, ready to hand to an auditor: every paid call over a window of up to a year, each with its time, tool and route, the amount paid, the rail and network, the settlement transaction or reference, the request and response SHA-256 digests, and the signed receipt issued for it, plus totals by tool and by day. Send POST /api/audit-report with no required fields (5 optional) and pay $0.01 per call over x402 with USDC on an EVM chain (the paying wallet is the identity). It returns raw bytes, not JSON, with Content-Type text/csv.
The report itself carries a summary receipt signed with the same published key, so anyone can check it with POST /api/receipts/verify or offline. Keyed to the wallet that pays for the call, never a parameter: nobody can read another wallet's report. Requires an EIP-3009 payment (USDC on an EVM chain). Use format "csv" for the rows as a CSV file; pages with cursor.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
from | string | no | ISO date or timestamp, inclusive. Default 30 days before "to". |
to | string | no | ISO date or timestamp, inclusive. Default now. The window is at most 366 days. |
limit | number | no | Rows per page, 1-1000 (default 200). Totals by tool and by day always cover the whole window. |
cursor | string | no | The nextCursor of the previous page (it carries the window; send it alone). |
format | string | no | "json" (default) or "csv": the rows as a text/csv file, with the summary receipt in the Agent402-Audit-Summary header and the next page's cursor in Agent402-Audit-Next-Cursor. |
Example request
curl -i -X POST https://agent402.tools/api/audit-report \
-H "Content-Type: application/json" \
-d '{"from":"2026-10-01","to":"2026-11-01","limit":200}'Without payment this returns HTTP 402 Payment Required with the exact price for audit-report; any x402 v2 or MPP client pays it and retries.
Watch a call get paid
POST /api/audit-report$0.01 USDCPAYMENT-SIGNATUREon 11 chains200 OKAgent402-ReceiptEd25519Example response
A 200 carries raw bytes, not JSON, with Content-Type text/csv: the file itself.
From an MCP client
catalog.call {
"slug": "audit-report",
"params": {
"from": "2026-10-01",
"to": "2026-11-01",
"limit": 200
}
}The hosted connector at https://agent402.tools/mcp needs a payment for audit-report; the stdio package pays it from a wallet. Local install: npx -y agent402-mcp@0.14.0.
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 or MPP: settlement runs after the tool and only on a successful response.
- Wallet-only: this tool reaches the network or stored state, so it has no proof-of-work tier.
- Identity-bound: results are keyed to the wallet that signed the payment, so only EVM x402 payments are accepted; credits keys and Tempo are refused.
- A
GETorHEADto /api/audit-report returns the same 402 quote, so the price can be read without a body. - An
Idempotency-Keyheader does not replay this tool's answer: the replay cache holds JSON answers only, so a retried paid call runs and is charged again.
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.01" }); // 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/audit-report", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"from": "2026-10-01",
"to": "2026-11-01",
"limit": 200
}),
});Related tools
My usage (wallet-keyed purchase history)
Your own purchase history, keyed to the wallet that pays for the call - no wallet parameter, no signup: the x402 payment.
Receipts (your settled calls, as accounting rows)
Your own settled calls in the shape a finance system posts: one row per payment with what was bought, the amount.
USDC balance
Read the USDC balance of any address on Base, Polygon, Arbitrum, Optimism, Ethereum, Monad, Celo, Avalanche, Sei.
x402 security audit
Grade any x402 seller's payment-security posture from the outside - a read-only black-box check mapped to the 'Five.
Wallet token transfers (filtered)
Recent token transfers for a wallet on Base, Ethereum and other EVM chains, newest first.
HTTP headers + security analysis
Fetch a URL and return every response header plus a security analysis: HSTS, CSP, X-Frame-Options.