{"uid":"cap_xBhQAvQX6jPsxPlB3q_5g","slug":"x402scan-j55w7ornb-merit-systems-vercel-app-adcaea93","name":"x402scan Merchant Aggregate Stats","description":"Aggregate stats for a merchant","url":"https://x402scan-j55w7ornb-merit-systems.vercel.app/api/data/merchants/:address/stats","method":"GET","headers":{},"bodySchema":null,"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}}},"response":{"data":{"total_amount":40000,"unique_buyers":4,"unique_sellers":1,"total_transactions":7,"latest_block_timestamp":"2026-05-19T14:58:17.000Z"}}},"exampleRequest":{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_LMhA7aH9WakigWWKvF_tU","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 on-chain statistics for a specific merchant address, including transaction count, total volume, and unique payer counts, optionally filtered by chain and timeframe.","exampleAgentPrompt":"Show me the aggregate stats for merchant address 0xABC123 on Base over the last 30 days — total transaction count, volume, and unique payers.","exampleUseCases":null,"resultDescription":"Returns aggregated statistics for the specified merchant address including total transaction count, cumulative payment volume, and number of unique payers, optionally scoped to a specific chain (base or solana) and a lookback timeframe of 1, 7, 14, or 30 days.","failureModes":["Invalid or unrecognized merchant address returns empty or null stats","Unsupported chain value (not 'base' or 'solana') may return a validation error","Unsupported timeframe value (not 1, 7, 14, or 30) may return an error or default behavior","Merchant with no recorded transactions returns zero-value stats","Payment of $0.01 USDC required; missing or failed x402 payment returns 402 error"],"whenToPreferThis":"Use this endpoint when you need a rolled-up summary of a specific merchant's payment activity on-chain (x402 protocol), such as total volume, transaction count, or unique payer count, and don't need individual transaction details. Prefer this over the transactions list endpoint when aggregated metrics are sufficient.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:43:38.853Z","isFirstParty":false}