Leaderboards API
Endpoints for discovering Polyanna leaderboard variants and fetching ranked trader rows for a specific tab and period.
All endpoint paths below start with /v1. See the general API page for authentication, rate limits, retry behavior, and shared error handling.
Endpoints#
List leaderboards#
https://polyanna.app/api/v1/leaderboardReturns metadata for all available leaderboard variants. Some leaderboard tabs are auth-gated and return redacted entries until the caller is authenticated. Use the id field to fetch a specific leaderboard via GET /leaderboard/{leaderboard_id}.
Parameters
No parameters.
Response
200Successful Response401Authentication required, or provided credentials are invalid422Validation Error429Rate limit exceeded503Service unavailableResponse body
itemsLeaderboardIndex[]Array of objects
Get leaderboard by ID#
https://polyanna.app/api/v1/leaderboard/{leaderboard_id}Returns a single leaderboard by its ID (e.g. volume-7d, roi-all). Auth-gated leaderboard tabs require authentication before their entries can be fetched. The ID format is {tab}-{period}. Call GET /leaderboard to discover available IDs.
Parameters
leaderboard_idstringrequiredpathlimitintegerqueryMax entries to return. Values above the default require Pro.
Response
200Successful Response401Authentication required, or provided credentials are invalid404Leaderboard not found422Validation Error429Rate limit exceeded503Service unavailableResponse body
entriesLeaderboardEntry[]generatedAtstringidstringperiodTimePeriodtabLeaderboardTabAPI Areas#
Authentication, rate limits, retries, errors, and shared API behavior.
Search traders, fetch public profiles, and read authenticated trader analytics.
Discover leaderboard variants and fetch a specific leaderboard by tab and period.
Read Whale Radar alerts, showcase rows, alert details, and Pro notification config.
Fetch Smart-Money Signals, weekly highlights, historical snapshots, and market-level signal analysis.