Trader API
Endpoints for searching traders, reading public trader profiles, and loading authenticated trader analytics.
All endpoint paths below start with /v1. See the general API page for authentication, rate limits, retry behavior, and shared error handling.
Endpoints#
List traders#
https://polyanna.app/api/v1/traderReturns all traders that appear on any leaderboard.
Parameters
No parameters.
Response
200Successful Response401Authentication required, or provided credentials are invalid422Validation Error429Rate limit exceeded503Service unavailableResponse body
itemsSearchableTrader[]Array of objects
Get trader profile#
https://polyanna.app/api/v1/trader/{address}Returns a trader's public profile including PnL, win rate, volume, trade count, market count, bot probability score, percentile ranks, and PnL series. When authenticated (Tier 2+), the response also includes analytics. The address is case-insensitive (lowercased automatically).
Parameters
addressstringrequiredpathPattern: ^0x[0-9a-fA-F]{40}$
Response
200Successful Response401Authentication required, or provided credentials are invalid404Trader not found422Validation Error429Rate limit exceeded503Service unavailableResponse body
addressstringanalyticsTraderAnalytics | nullnullablebiostring | nulloptionalnullablebotComponentsBotScoreComponents | nulloptionalnullablebotProbabilitynumbermarketCountintegermaxDrawdownnumber | nulloptionalnullablememberSincestringpercentilesPercentileRanks | nulloptionalnullablepnlnumberpnlSeriesPnlDataPoint[]profileImagestring | nulloptionalnullableroinumber | nulloptionalnullableshareVolumenumbersharpeRationumber | nulloptionalnullabletotalBoughtnumber | nulloptionalnullabletradeCountintegerusdVolumenumberusernamestringverifiedBadgebooleanoptionalwinRatenumberxUsernamestring | nulloptionalnullableGet trader analytics#
https://polyanna.app/api/v1/trader/{address}/analyticsReturns deeper trader analytics including profile summary, risk metrics, and behavior breakdowns. The address is case-insensitive (lowercased automatically).
Parameters
addressstringrequiredpathPattern: ^0x[0-9a-fA-F]{40}$
Response
200Successful Response401Authentication required, or provided credentials are invalid403Authenticated caller does not have access to this route404Trader not found422Validation Error429Rate limit exceeded503Service unavailableResponse body
avgPositionSizenumberavgTradesPerMarketnumberbiggestLossTradeRecord | nulloptionalnullablebiggestWinTradeRecord | nulloptionalnullablecategoryBreakdownCategoryCount[]dominantMarketstring | nulloptionalnullablehourlyActivityHourlyActivity[]optionallossStreakintegermarketSignalsMarketSignalsSummary | nulloptionalnullablepnlConcentrationTop3SharenumberoptionaltopicEdgeTopicEdgeSummary | nulloptionalnullablewinStreakintegerAPI 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.