{"uid":"cap_BBfVZS6x2sBDx4nsmQgBh","slug":"arkham-x402-polymarket-leaderboard-78bbc936","name":"Arkham x402 Polymarket Leaderboard","description":"Get Arkham Polymarket leaderboard. $2.00 per call.","url":"https://api.arkm.com/x402/polymarket/leaderboard","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Max entries (1-200). Default: 100"},"order":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Sort order: desc (top traders) or asc (worst traders). Default: desc"},"offset":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Pagination offset. Default: 0"},"period":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Time period: 1d, 1w, 1m, all. Default: 1d"},"address":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional trade address. If set, also returns this user's rank."}}},"responseSchema":{"type":"json","example":{"sort":"desc","period":"1d","entries":[{"rank":1,"tags":[{"tag":"baseball","label":"Baseball","events":18648,"volume":"13142524.850084"},{"tag":"games","label":"Games","events":18648,"volume":"13142524.850084"},{"tag":"mlb","label":"Mlb","events":18648,"volume":"13142524.850084"}],"periodPnl":"300749.583652","tokensWon":123,"tradeCount":142,"tokensTotal":238,"userAddress":"0x5e9458202b5817A72Cf81105EC8A30e6f3705ba1"},{"rank":2,"tags":[{"tag":"games","label":"Games","events":17425,"volume":"42549972.811718"},{"tag":"sports","label":"Sports","events":17425,"volume":"42549972.811718"},{"tag":"baseball","label":"Baseball","events":4135,"volume":"18799123.407022"}],"periodPnl":"252263.11266239","tokensWon":241,"tradeCount":20,"tokensTotal":514,"userAddress":"0x4BFF30Af91642dc7d2b19A8664378Fe55C45Fc26"},{"rank":3,"tags":[{"tag":"politics","label":"Politics","events":4504,"volume":"5195284.291581"},{"tag":"fed","label":"Fed","events":3764,"volume":"3576222.36051"},{"tag":"fed-rates","label":"Fed Rates","events":3663,"volume":"3551694.256846"}],"periodPnl":"189114.8628772455","tokensWon":748,"tradeCount":104,"tokensTotal":1227,"userAddress":"0x3A8aa345D5Db7ec5138298C8C4f4540259be7699"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"2","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":"$2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_K9uKM7heuGloeO6XU9FCu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a ranked leaderboard of top Polymarket traders with PnL, trade counts, token stats, and market category breakdowns for a given time period.","exampleAgentPrompt":"Pull the Polymarket leaderboard for the last 24 hours sorted descending by PnL — I want to see the top traders, their wallet addresses, profit figures, trade counts, and which market categories they're trading in.","exampleUseCases":[{"title":"Identify top prediction market traders","prompt":"Who are the top 10 wallets making the most money on Polymarket today? Show me their PnL, how many trades they made, and what categories they're focused on — sorted from highest to lowest profit."},{"title":"Research profitable Polymarket strategies by category","prompt":"Pull the Polymarket leaderboard for the past day and tell me which market categories — like politics, sports, or crypto — the top-ranked traders are concentrating their volume in."},{"title":"Monitor whale activity on Polymarket","prompt":"I want to track the highest-earning Polymarket wallet addresses over the last 24 hours. Give me their ranks, total PnL, and trade counts so I can watch for patterns in how they're positioning."}],"resultDescription":"A JSON object containing a sorted array of leaderboard entries, each with: rank, wallet address, period PnL (in USD), tokens won, total tokens, trade count, and an array of market category tags with label, event count, and volume for each category.","failureModes":["Invalid or missing sort/period parameters return an error response","x402 payment failure if USDC balance is insufficient (endpoint requires $2 USDC per call)","Empty leaderboard if no trading activity occurred in the specified period","Rate limiting or authentication errors if API key is invalid","Network timeout if Arkham backend is under load"],"whenToPreferThis":"Use this endpoint when you need ranked, on-chain Polymarket trader performance data enriched with wallet intelligence from Arkham — especially when you want PnL-sorted leaderboards with category breakdowns. Prefer this over raw on-chain queries when you need pre-aggregated stats across multiple market tags without building your own indexer.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:39:43.642Z","isFirstParty":false}