{"uid":"cap_fcBpoc6cA6L3Hu2lB3kiR","slug":"x402scan-merchant-leaderboard-65241bfe","name":"x402scan Merchant Leaderboard","description":"Paginated list of merchants (top recipients by volume)","url":"https://x402scan-git-router-117-merit-systems.vercel.app/api/x402/merchants","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","required":["page","page_size","sort_by"],"properties":{"page":{"type":"integer","default":0,"maximum":9007199254740991,"minimum":0,"description":"Page index (0-based)"},"chain":{"enum":["base","solana"],"type":"string","description":"Filter by chain"},"sort_by":{"enum":["volume","tx_count","unique_buyers"],"type":"string","default":"volume","description":"Sort field"},"page_size":{"type":"integer","default":10,"maximum":100,"minimum":1,"description":"Items per page (1-100, default 10)"},"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_YI0KFiU2zOfA-Oz9Wbq0P","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 a paginated, sorted list of top merchants by payment volume, transaction count, or unique buyers on x402-enabled chains","exampleAgentPrompt":"Show me the top 10 x402 merchants on Base ranked by volume over the last 7 days — start from page 0.","exampleUseCases":[{"title":"Identify top-earning x402 merchants","prompt":"Who are the top 20 merchants receiving x402 payments on Base over the last 30 days, sorted by total volume? Show me the first page."},{"title":"Find most active merchants by transactions","prompt":"Pull up the x402 merchant leaderboard sorted by transaction count for the past week on Solana — first 10 results."},{"title":"Discover merchants with broadest buyer reach","prompt":"Which x402 merchants have the most unique buyers in the last 14 days? Give me the top 10 sorted by unique buyers across all chains."}],"resultDescription":"A paginated list of merchant records ranked by the chosen metric (volume, tx_count, or unique_buyers), filtered optionally by chain and timeframe, with fields indicating each merchant's address, total payment volume, transaction count, unique buyers, and chain.","failureModes":["Invalid page or page_size values outside allowed range returns 400 error","Unsupported chain or sort_by enum value returns 400 validation error","No merchants found for the given filter combination returns empty list","Service unavailable or Vercel deployment error returns 500","Rate limiting or payment failure (x402 $0.01 USDC not settled) returns 402"],"whenToPreferThis":"Use this endpoint when you need a ranked directory of x402 payment recipients — especially to discover high-volume or highly-active merchants in the x402 ecosystem on Base or Solana. Prefer it over individual merchant stat endpoints when you need comparative or leaderboard-style views across multiple merchants rather than drilling into a single merchant.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:31:01.990Z","isFirstParty":false}