{"uid":"cap_Rwck0lrvLDFC1D8Hhpnji","slug":"scanna-polymarket-trader-leaderboard-868f3315","name":"Scanna Polymarket Trader Leaderboard","description":"Top Polymarket traders by realised PnL or volume. Normally a 5-minute shared cache, but if upstream fails we serve the last good copy for UP TO 24 HOURS, still as a 200, signalled only by the X-Data-Freshness header. 503 only when nothing is cached at all. Upstream rows are sparse: proxy_wallet is the only guaranteed field; pnl and volume can be null and trades can be absent. limit is truncated locally before enrichment, so it bounds work. Empty bills.","url":"https://api.scanna.xyz/leaderboard","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","required":[],"properties":{"limit":{"type":"integer","default":50,"maximum":100,"minimum":1,"description":"Traders to return. Applied locally before enrichment, so it bounds the work, not just the body."},"order":{"enum":["PNL","VOLUME"],"type":"string","default":"PNL","description":"Ranking key. Anything other than VOLUME is treated as PNL."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["leaderboard","order","count"],"properties":{"count":{"type":"integer"},"order":{"enum":["PNL","VOLUME"],"type":"string"},"leaderboard":{"type":"array","items":{"type":"object","required":["proxy_wallet"],"properties":{"pnl":{"type":"number","description":"Rounded to whole USD"},"name":{"type":["string","null"]},"trades":{"type":"integer","description":"Upstream trade count"},"volume":{"type":"number","description":"Rounded to whole USD"},"win_rate":{"type":["number","null"],"description":"OUR win rate, 2dp. Null when we have never scored this wallet."},"proxy_wallet":{"type":"string"},"trades_local":{"type":["integer","null"],"description":"Trades WE have scored — deliberately not the upstream count."}}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.010012","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.010012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.010012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.010012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QWNAYODpmCaBTkNw4obod","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.010012","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns top Polymarket traders ranked by realised PnL or trading volume, with win rate and trade count enrichment","exampleAgentPrompt":"Show me the top 20 Polymarket traders ranked by realised PnL — I want to see their wallet addresses, profit numbers, and win rates.","exampleUseCases":[{"title":"Identify top profitable prediction traders","prompt":"Pull the top 25 Polymarket traders by realised PnL so I can see who's been most profitable and what their win rates look like."},{"title":"Volume-based trader discovery","prompt":"Give me the 50 highest-volume traders on Polymarket — I want to find the most active wallets regardless of whether they're profitable."},{"title":"Benchmark trading performance","prompt":"Get the top 10 Polymarket traders ranked by PnL — I want to compare their profit figures, trade counts, and win rates to understand what elite performance looks like on the platform."}],"resultDescription":"A JSON object containing an ordered leaderboard array of trader records, each with proxy_wallet (always present), pnl (USD rounded, may be null), volume (USD rounded, may be null), trades (upstream count, may be absent), trades_local (Scanna-scored trade count, may be null), win_rate (Scanna-calculated to 2dp, null if wallet never scored), and name (may be null). Also returns the total count and the ranking order used. Data may be up to 24 hours stale if upstream is unavailable, signalled via the X-Data-Freshness response header.","failureModes":["503 returned only when no cached data exists at all — no fallback available","Upstream data sparsity: pnl and volume fields can be null for many traders","win_rate is null for wallets Scanna has never independently scored","trades field can be absent from upstream rows","Data may be silently stale up to 24 hours — must check X-Data-Freshness header to detect","limit parameter is truncated locally before enrichment so very high limits may still return fewer enriched rows"],"whenToPreferThis":"Use this endpoint when you need a ranked snapshot of top Polymarket traders by profit or volume, especially when you also want Scanna's independently calculated win rate alongside upstream PnL/volume figures. Prefer this over raw Polymarket data when enrichment (win rate, local trade scoring) adds value. Choose PNL order to find most profitable traders; choose VOLUME to find most active. Be aware data freshness can lag up to 24 hours under upstream failure conditions — check the X-Data-Freshness header if recency matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:36:34.497Z","isFirstParty":false}