{"uid":"cap_kZOzuki2-f-EGw4M9xC13","slug":"x402-data-api-seller-revenue-analytics-2bd97e81","name":"x402 Data API – Seller Revenue Analytics","description":"What a seller's payTo address earned from x402 payments on Base in the last days, read from the chain: total, distinct and repeat payers, per day, per price, top payers and recent payments, with plain USDC transfers counted apart and your own test wallets left out on request. Includes the seller's Bazaar listings with their payers, calls and measured uptime.","url":"https://tb2s28fm0h8dkq2t.68r.lambda-web.us-east-1.on.aws/v1/revenue?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["pay_to"],"properties":{"days":{"type":"integer","description":"period in days (1-14, default 7)"},"pay_to":{"type":"string","description":"the seller's payTo address (0x...)"},"exclude":{"type":"string","description":"comma separated payer addresses to leave out, such as your own test wallets (up to 10)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"by_day":{},"payers":{},"by_price":{},"listings":{},"payments":{},"total_usd":{},"top_payers":{},"repeat_payers":{}}}}}}},"responseSchema":null,"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_lYG1kLkgiLTvo6QAmF92o","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 on-chain revenue analytics for a given seller's payTo address from x402 payments on Base: totals, payer counts, daily breakdowns, top payers, and Bazaar listing uptime.","exampleAgentPrompt":"Show me the x402 revenue for my seller address 0xAbC123... over the last 7 days — break it down by day and show my top payers, and exclude 0xTestWallet1 and 0xTestWallet2 from the results.","exampleUseCases":[{"title":"Weekly revenue report for seller","prompt":"Pull my x402 earnings for the last 7 days for payTo address 0x1234abcd... — I want to see total revenue, how many unique payers I had, and the day-by-day breakdown."},{"title":"Identifying top and repeat payers","prompt":"For my x402 payTo address 0xABC999..., show me who my top payers are and how many have come back more than once over the last 14 days — exclude my own test wallet 0xTestMe99."},{"title":"Monitoring Bazaar listing uptime","prompt":"Can you check the uptime and call stats for all my Bazaar listings tied to seller address 0xDEF456... over the past week?"}],"resultDescription":"A JSON object containing: total USD earned, count of distinct and repeat payers, revenue broken down by day and by price tier, a list of top payers with amounts, recent individual payments, plain USDC transfer totals counted separately, and Bazaar listing details including per-listing payers, call counts, and measured uptime percentages.","failureModes":["Missing or invalid pay_to address returns an error or empty result","days parameter outside 1-14 range may be rejected or clamped","More than 10 addresses in exclude parameter may be rejected","Address with no x402 payment history returns zero totals","Network or chain indexing delays may cause recent payments to be missing","Lambda cold start may cause occasional latency spikes"],"whenToPreferThis":"Use this endpoint when you need on-chain x402 revenue analytics for a specific seller address on Base, including payer breakdowns, daily trends, and Bazaar listing health. It uniquely combines blockchain payment data with Bazaar marketplace uptime metrics in a single call, and supports test wallet exclusion. Prefer this over generic blockchain explorers when you need structured, aggregated seller-side revenue intelligence for the x402 ecosystem.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-25T12:30:43.153Z","isFirstParty":false,"canonicalSlug":"x402-data-api-seller-revenue-analytics-2bd97e81"}