{"uid":"cap_HBV-Yu7eiRY_igiVhQRn1","slug":"x402scan-merchant-aggregate-stats-fb609619","name":"x402scan Merchant Aggregate Stats","description":"Aggregate stats for a merchant","url":"https://x402scan-git-router-117-merit-systems.vercel.app/api/x402/merchants/:address/stats","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"chain":{"enum":["base","solana"],"type":"string","description":"Filter by chain"},"timeframe":{"anyOf":[{"type":"number","const":1},{"type":"number","const":7},{"type":"number","const":14},{"type":"number","const":30}],"description":"Days lookback (1, 7, 14, or 30)"}},"additionalProperties":false}},"additionalProperties":false}}},"responseSchema":null,"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_HmxXV8CyowbjTQ17vWOTb","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 aggregate transaction statistics for a specific x402 merchant address, filterable by blockchain and time window","exampleAgentPrompt":"Pull the x402scan aggregate stats for merchant address 0xAbC123... on Base over the last 30 days — I want to see their total volume and transaction count.","exampleUseCases":null,"resultDescription":"Returns a JSON object containing aggregate statistics for the specified merchant address, such as total transaction count, total payment volume, and revenue figures, optionally scoped to a specific chain (base or solana) and a lookback window of 1, 7, 14, or 30 days.","failureModes":["Invalid or unrecognized merchant address returns 404 or empty stats","Unsupported chain value returns 400 validation error","Unsupported timeframe value (not 1, 7, 14, or 30) returns 400 validation error","Merchant has no activity in selected timeframe returns zeroed stats","Payment not received causes 402 Payment Required before data is returned"],"whenToPreferThis":"Use this endpoint when you need a quick, pre-aggregated summary of an x402 merchant's payment activity — total volume, transaction counts — rather than individual transaction records. Ideal for dashboards, performance monitoring, or comparing merchant activity across chains or time periods without running raw queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:32:48.366Z","isFirstParty":false}