Back to Browse
agent402.tools My Usage History
x402
agent402.tools My Usage History is a paid API for AI agents from agent402.tools, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-30).
Returns the calling wallet's own API usage history — totals, per-tool counts, per-chain breakdown, and recent receipts — authenticated solely by the x402 micropayment itself.
Price / call$0.005
Success—
StatusUnknown
How this service works
Your own purchase history, keyed to the wallet that pays for the call - no wallet parameter, no signup: the x402 payment IS the identity, so nobody can read another wallet's profile. Returns totals, per-tool counts, per-chain breakdown, recent receipts with settle tx hashes (independently verifiable on-chain), and this wallet's refunds: any payment that settled for a call that failed to deliver, with its status and our refund transaction once sent.
Output
Returns aggregated usage statistics for the paying wallet: total call counts and spend, per-tool breakdowns, per-chain spend distribution, and a list of recent receipt records (up to the requested limit). No wallet parameter is needed; identity is derived from the x402 payment credential.
Example use cases
Example prompt
“Show me my agent402 usage for the last 7 days — how many calls I made per tool and a breakdown by chain — and return my 20 most recent receipts.”
Technical details
Endpoint
POSThttps://agent402.tools/api/my-usage?utm_source=zero.xyzWhen to prefer
Use this endpoint when an agent or user wants to inspect their own historical API usage and spend on the agent402.tools platform, authenticated purely by their wallet's x402 payment — no OAuth, no API key, no signup required. Prefer over generic analytics tools when the context is specifically micropayment-keyed identity and per-tool receipt history on the x402 network.
Side effects
- Invalid days value outside 1-365 range returns a validation error
- Invalid limit value outside 1-200 range returns a validation error
- Missing or invalid x402 payment header results in a 402 Payment Required response
- No usage history found for wallet returns empty totals and empty receipt list
- Network timeout or upstream database error returns a 5xx error
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| days | number | Aggregation window in days, 1-365 (default 30). The recent list is always the latest rows regardless. |
| limit | number | Max recent receipts to return, 1-200 (default 50) |
Output
Schema · Response
{
"type": "json",
"example": {
"days": 30,
"note": "Every USDC row keeps its settle tx - verifiable on-chain.",
"bySlug": [
{
"usd": 0.012,
"slug": "hash",
"calls": 12,
"lastAt": "2026-07-09T00:00:00.000Z"
}
],
"recent": [
{
"at": "2026-07-09T00:00:00.000Z",
"tx": "0x…",
"slug": "hash",
"network": "base",
"priceUsd": 0.001
}
],
"totals": {
"calls": 42,
"lastAt": "2026-07-09T00:00:00.000Z",
"firstAt": "2026-07-01T00:00:00.000Z",
"paidUsd": 1.234
},
"wallet": "0xb0b0000000000000000000000000000000000b0b",
"refunds": {
"rows": [
{
"tx": "0x…",
"chain": "base",
"status": "paid",
"network": "eip155:8453",
"refundTx": "0x…",
"amountUsd": 0.005,
"recordedAt": "2026-07-09T00:00:00.000Z",
"refundedAt": "2026-07-09T01:00:00.000Z",
"refundTxUrl": "https://basescan.org/tx/0x…"
}
],
"count": 1,
"owedUsd": 0,
"paidUsd": 0.005
},
"byNetwork": {
"base": {
"usd": 1.2,
"calls": 40
},
"polygon": {
"usd": 0.034,
"calls": 2
}
},
"persistent": true
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"