Skip to content

Audit report (one wallet's paid history, signed)

$0.01 per callUSDC via x402POST /api/audit-report

An 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.

Category: Payments & x402Tags: audit receipts compliance accounting export csv wallet historyAlso found as: audit audit-export compliance-report spend-report agent-audit

Try in playground →

Parameters

NameTypeRequiredDescription
fromstringnoISO date or timestamp, inclusive. Default 30 days before "to".
tostringnoISO date or timestamp, inclusive. Default now. The window is at most 366 days.
limitnumbernoRows per page, 1-1000 (default 200). Totals by tool and by day always cover the whole window.
cursorstringnoThe nextCursor of the previous page (it carries the window; send it alone).
formatstringno"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

RequestPOST /api/audit-report
402$0.01 USDC
SignPAYMENT-SIGNATURE
Settleon 11 chains
Answer200 OK
ReceiptAgent402-ReceiptEd25519

Example 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

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)

$0.005POST /api/my-usage

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)

$0.005POST /api/receipts

Your own settled calls in the shape a finance system posts: one row per payment with what was bought, the amount.

USDC balance

$0.001GET /api/usdc-balance

Read the USDC balance of any address on Base, Polygon, Arbitrum, Optimism, Ethereum, Monad, Celo, Avalanche, Sei.

x402 security audit

$0.01GET /api/x402-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)

$0.003POST /api/asset-transfers

Recent token transfers for a wallet on Base, Ethereum and other EVM chains, newest first.

HTTP headers + security analysis

$0.003POST /api/http-headers

Fetch a URL and return every response header plus a security analysis: HSTS, CSP, X-Frame-Options.