{"uid":"cap_g5oZ8ffJ0f4Uod6cNwxkM","slug":"x402-revenue-analytics-by-seller-address-c1fbe3a5","name":"x402 Revenue Analytics by Seller Address","description":"Data about the x402 market: the CDP Bazaar's listings, sellers, prices and categories, new listings and price changes from snapshots every 6 hours, uptime we measure for every paid listing, and x402 spending of any wallet and revenue of any seller on Base.","url":"https://data.kagurazaka.dev/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":{"type":"json","example":{"by_day":[{"usd":0.08,"date":"2026-10-24","payers":3,"payments":12}],"payers":9,"by_price":[{"usd":0.005,"payments":50}],"listings":[{"resource":"https://api.example/v1/x","calls_30d":61,"price_usd":0.005,"payers_30d":9,"uptime_30d":1}],"payments":61,"total_usd":0.42,"top_payers":[{"usd":0.15,"payer":"0x...","payments":30}],"repeat_payers":4}},"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_jB0bMapLbhuST5aBWZ-7q","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 an x402 seller's payTo address on Base, including totals, payer counts, daily breakdown, top payers, and Bazaar listing uptime.","exampleAgentPrompt":"Show me my x402 revenue stats for payTo address 0xABC123... over the last 14 days, and exclude my test wallet 0xDEF456... from the results.","exampleUseCases":[{"title":"Weekly seller revenue dashboard","prompt":"Pull my x402 earnings for payTo address 0x1234abcd... for the last 7 days — I want to see the total, how many unique payers I had, and the day-by-day breakdown."},{"title":"Identify top paying API customers","prompt":"Who are my top payers on x402 for address 0xSeller... over the past 14 days? I want to see how much each one spent and how many calls they made."},{"title":"Monitor Bazaar listing health","prompt":"Check the uptime and call counts for all my Bazaar listings under payTo address 0xMyAddress... — I want to know if any of them have been going down."}],"resultDescription":"A JSON object containing: total USD earned, total payment count, distinct payer count, repeat payer count, an array of per-day stats (date, payments, payers, USD), per-price-tier breakdowns, top payers with their totals, recent payment list, and an array of Bazaar listings with price, 30-day payer count, 30-day call count, and uptime ratio.","failureModes":["Missing pay_to parameter returns 400 or empty result","Invalid address format causes no matching on-chain data","days out of range (>14 or <1) may return error or default to 7","exclude list exceeding 10 addresses may be truncated or rejected","No payments found for the address returns zero totals","Network or chain indexing lag may cause slightly stale data"],"whenToPreferThis":"Use this endpoint when you need seller-side revenue analytics for a specific x402 payTo address on Base — covering earnings, payer demographics, daily trends, and Bazaar listing performance. Prefer this over the buyer-side spend endpoint when the user is an API seller wanting to understand their income. Prefer this over the market-wide leaderboard endpoints when you need granular per-address data rather than rankings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:36:32.860Z","isFirstParty":false,"canonicalSlug":"x402-revenue-analytics-by-seller-address-c1fbe3a5"}