{"uid":"cap_qZ0W30vgp9RcAPZsgyeYm","slug":"agent402-tools-my-usage-history-b7d54e18","name":"agent402.tools My Usage History","description":"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, and recent receipts with settle tx hashes (independently verifiable on-chain). Requires an EIP-3009 payment (USDC on Base, Polygon, or Arbitrum); Solana/Stellar payments carry no signed payer the server can verify.","url":"https://agent402.tools/api/my-usage","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"days":{"type":"number","description":"Aggregation window in days, 1-365 (default 30). The recent list is always the latest rows regardless."},"limit":{"type":"number","description":"Max recent receipts to return, 1-200 (default 50)"}}},"responseSchema":{"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":"0x902dcf34e53695bdea2ffb354b1a2e58bd598256","byNetwork":{"base":{"usd":1.2,"calls":40},"polygon":{"usd":0.034,"calls":2}},"persistent":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_szWHybKA7Kfsmkzp4X9NS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T20:45:26.358Z","isFirstParty":false}