{"uid":"cap_LNLZsC8CDsViX7fDbiS_i","slug":"payerproof-revenue-stats-a37b796d","name":"PayerProof Revenue Stats","description":"Verified on-chain USDC revenue stats for any x402 seller address on Base: total received, transfer count, unique payers, top-payer concentration, largest transfers. Window up to 720h (30d), incremental coverage.","url":"https://payerproof-production.up.railway.app/revenue?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"window":{"hours":24,"complete":true,"hoursCovered":24},"address":"0x...","totalUsdcIn":12.34,"uniquePayers":18,"topPayerShare":0.22,"transferCount":210}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0v711AbJxAEW-7kIzrf7C","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns verified on-chain USDC revenue analytics for a given x402 seller address on Base, including total received, transfer count, unique payers, top-payer concentration, and largest transfers over a configurable time window up to 30 days.","exampleAgentPrompt":"Pull the on-chain USDC revenue stats for seller address 0xAbC123... over the last 48 hours — I want total received, number of unique payers, transfer count, and what share my top payer represents.","exampleUseCases":[{"title":"Daily revenue dashboard for x402 seller","prompt":"Give me today's on-chain USDC stats for my x402 address 0xAbC123... — total received, how many transfers came in, and how many unique payers sent me money in the last 24 hours."},{"title":"Auditing a claimed payer concentration","prompt":"I want to verify whether seller address 0xDef456... is telling the truth about having diverse revenue — pull their top-payer share and unique payer count from the last 720 hours on Base."},{"title":"Weekly x402 API earnings review","prompt":"Summarize my x402 API earnings for the past 7 days — use address 0x789XyZ... and give me total USDC received, number of transfers, and whether the data window is fully covered."}],"resultDescription":"A JSON object containing: the queried seller address, a window object (hours requested, whether coverage is complete, hours actually covered), totalUsdcIn (sum of USDC received), uniquePayers (distinct sender count), topPayerShare (fraction from top single payer), and transferCount (total on-chain transfers in the window).","failureModes":["Invalid or malformed wallet address returns an error or empty result","Window exceeding 720 hours may be rejected or capped","Incomplete coverage flagged when blockchain indexing hasn't caught up (complete: false, hoursCovered < hours)","Address with zero transactions returns zeroed stats","Network or Railway hosting downtime causes 5xx responses","Rate limiting or payment failure for the $0.01 USDC x402 fee blocks the request"],"whenToPreferThis":"Choose this endpoint when you need cryptographically verifiable, on-chain USDC revenue metrics for a Base address that participates in the x402 micropayment protocol — particularly when you need payer diversity metrics (unique payers, top-payer concentration) that go beyond simple balance checks. Prefer this over generic blockchain explorers when you want pre-aggregated analytics without parsing raw transaction logs yourself.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T06:31:13.531Z","isFirstParty":false,"canonicalSlug":"payerproof-revenue-stats-a37b796d"}