{"uid":"cap_uXvN_Hk9U1WxULkevZGbA","slug":"aisa-mpp-data-apis-polymarket-trader-leaderboard-736879e1","name":"Polymarket Trader Leaderboard","description":"Returns trader leaderboard rankings for a selected category and time period.\n\n<!-- aisa-pricing:start -->\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","url":"https://api.aisa.one/apis/v1/polymarket/v1/leaderboard?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"user":{"type":"string","example":"0x56687bf447db6ffa42ffe2204a05edaa20f55839","pattern":"^0x[a-fA-F0-9]{40}$","description":"Limit leaderboard to a single user by address"},"limit":{"type":"integer","default":25,"maximum":50,"minimum":1,"description":"Max number of leaderboard traders to return"},"offset":{"type":"integer","default":0,"maximum":1000,"minimum":0,"description":"Starting index for pagination"},"orderBy":{"enum":["PNL","VOL"],"type":"string","default":"PNL","description":"Leaderboard ordering criteria"},"category":{"enum":["OVERALL","POLITICS","SPORTS","ESPORTS","CRYPTO","CULTURE","MENTIONS","WEATHER","ECONOMICS","TECH","FINANCE"],"type":"string","default":"OVERALL","description":"Market category for the leaderboard"},"userName":{"type":"string","description":"Limit leaderboard to a single username"},"timePeriod":{"enum":["DAY","WEEK","MONTH","ALL"],"type":"string","default":"DAY","description":"Time period for leaderboard results"}}},"responseSchema":{"type":"array","items":{"type":"object","properties":{"pnl":{"type":"number","description":"Profit and loss for this trader"},"vol":{"type":"number","description":"Trading volume for this trader"},"rank":{"type":"string","description":"The rank position of the trader"},"userName":{"type":"string","description":"The trader's username"},"xUsername":{"type":"string","description":"The trader's X (Twitter) username"},"proxyWallet":{"type":"string","example":"0x56687bf447db6ffa42ffe2204a05edaa20f55839","pattern":"^0x[a-fA-F0-9]{40}$","description":"User Profile Address (0x-prefixed, 40 hex chars)"},"profileImage":{"type":"string","description":"URL to the trader's profile image"},"verifiedBadge":{"type":"boolean","description":"Whether the trader has a verified badge"}}}},"example":null,"exampleRequest":null,"tags":["web-search","financial-data","prediction-markets","weather","travel","data","search"],"displayCostAmount":"0.012","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.012/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_n4qDRecx8FCF7GjT-vKEz","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.012","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"AIsa MPP Data APIs","brandSlug":"aisa-mpp-data-apis-mpp","brandBaseUrl":"https://aisa.one","brandDocsUrl":null,"whatItDoes":"Returns ranked trader leaderboard data from Polymarket for a selected category and time period, ordered by PnL or volume.","exampleAgentPrompt":"Who are the top 10 Polymarket traders by PnL in the crypto category over the past month?","exampleUseCases":[{"title":"Identify top weekly politics traders","prompt":"Show me the top 25 Polymarket traders in the politics category ranked by PnL for this week — I want their usernames and how much profit they've made."},{"title":"Track a specific trader's ranking","prompt":"Look up where Polymarket user 'CryptoOracle' ranks on the overall leaderboard for all time, sorted by PnL."},{"title":"Find highest-volume esports bettors","prompt":"Who are the top 10 Polymarket traders by trading volume in the esports category today?"}],"resultDescription":"An array of trader objects, each containing rank position, username, X (Twitter) username, proxy wallet address, profit/loss amount, trading volume, profile image URL, and whether the trader has a verified badge.","failureModes":["Invalid wallet address format (must be 0x-prefixed 40-char hex) returns a validation error","Offset exceeding 1000 or limit exceeding 50 returns a parameter validation error","Invalid enum values for category, timePeriod, or orderBy return a bad request error","Username or wallet address not found returns an empty array","Network or upstream Polymarket API outage returns a 5xx error"],"whenToPreferThis":"Use this endpoint when you need ranked trader performance data specifically from Polymarket prediction markets, with support for filtering by market category (politics, crypto, sports, etc.), time period, and ordering by PnL or volume. Prefer this over general financial leaderboards when the user's question is specifically about prediction market traders.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:57:01.181Z","isFirstParty":false,"canonicalSlug":"aisa-mpp-data-apis-polymarket-trader-leaderboard-736879e1"}