{"uid":"cap_JxMqt_Ep3xTLb0vDRlg8T","slug":"x402scan-j55w7ornb-merit-systems-vercel-app-b3f3e7bc","name":"x402scan Merchant Stats","description":"Fetch aggregated merchant metrics (sales, revenue, order count, and payment token details) for a given merchant address via x402.","url":"https://x402scan-j55w7ornb-merit-systems.vercel.app/api/data/merchants/0xf7b1356cfed0eebe01d76da7ba9e9f8bf12d9d57/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"],"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":{"type":"number","description":"Days lookback (1, 7, 14, or 30)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["total_amount","unique_buyers","unique_sellers","total_transactions","latest_block_timestamp"],"properties":{"total_amount":{"type":"number"},"unique_buyers":{"type":"number"},"unique_sellers":{"type":"number"},"total_transactions":{"type":"number"},"latest_block_timestamp":{"type":"null"}}}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"chain":"base","timeframe":7}}},"response":{"data":{"total_amount":0,"unique_buyers":0,"unique_sellers":0,"total_transactions":0,"latest_block_timestamp":null}}},"exampleRequest":{"chain":"base","timeframe":7},"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_mDeb5xszsu43aP18jyBaJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns aggregated merchant metrics (total revenue, transaction count, unique buyers, and latest block timestamp) for a specific merchant address on the x402 payment network.","exampleAgentPrompt":"Can you pull the last 7 days of sales stats for merchant address 0xf7b1356cfed0eebe01d76da7ba9e9f8bf12d9d57 on the Base chain — I want to see total revenue, transaction count, and unique buyer numbers from x402scan.","exampleUseCases":[{"title":"Monitor weekly merchant performance dashboard","prompt":"Hey, can you grab the sales metrics for our top merchant 0x8a2e3f4b9c1d5a7e6f2b4c9d1e3f5a7b from the last week? I need the total revenue, how many transactions went through, and unique buyer count so I can update our performance report."},{"title":"Analyze competitor sales on blockchain","prompt":"I'm trying to understand our competition better. Can you pull the aggregated stats for that merchant at 0x9f4c2e8a1b5d7a3f6e9c2b5d8a1f4c7e on Base? Show me their total sales volume, transaction count, and how many unique customers they're reaching."},{"title":"Verify merchant payout calculations","prompt":"Before we process payouts, can you fetch the revenue metrics for merchant 0x5b3a9f2c8e1d4a7b6f3c9e2a5d8b1f4c? I need to confirm their total amount earned, number of transactions processed, and unique buyer count to make sure our numbers match."}],"resultDescription":"Returns a JSON object with total_amount (in smallest token units), unique_buyers count, unique_sellers count, total_transactions count, and latest_block_timestamp for the given merchant over the specified timeframe and chain.","failureModes":["Invalid or unrecognized merchant address returns empty or error response","Unsupported chain value returns validation error","Timeframe value outside allowed set (1, 7, 14, 30) may return error or default behavior","Merchant has no transactions in the given timeframe — returns zeros","Payment of $0.01 USDC not fulfilled causes 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you need aggregated performance metrics (revenue, transaction volume, buyer reach) for a known merchant address on the x402 protocol. Prefer this over the transaction-history endpoints when you want rolled-up stats rather than individual transfer records, and when you want chain-specific or time-windowed summaries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:42:55.820Z","isFirstParty":false}