Whale Radar API
Endpoints for reading tier-shaped Whale Radar alerts, fetching a single alert, loading the curated showcase, and managing Pro notification config.
All endpoint paths below start with /v1. See the general API page for authentication, rate limits, retry behavior, and shared error handling.
Endpoints#
List Whale Radar alerts#
https://polyanna.app/api/v1/whalesReturns Whale Radar alerts. Anonymous and Free callers receive a delayed, redacted feed. Pro callers receive real-time identity, filters, and cursor pagination.
Parameters
limitintegerquerycategorystringquerymin_usdnumberquerydirectionstringqueryPro-only. Must be BUY or SELL.
qualifyingstringqueryPro-only. Must be one of prescience, consistent, copyable.
walletstringquerycursorstringqueryPro-only cursor alert id.
Response
200Successful Response422Validation ErrorResponse body
itemsWhaleAlert | WhaleAlertPublic[]next_cursorstring | nulloptionalnullableGet Whale Radar alert#
https://polyanna.app/api/v1/whales/{alert_id}Returns one Whale Radar alert with identity shaped by caller tier.
Parameters
alert_idstringrequiredpathResponse
200Successful Response404Whale alert not found422Validation ErrorResponse body
created_atstringdirectionstringfill_tx_hashstringfilled_atstringidstringimage_urlstring | nulloptionalnullablemarket_categorystringmarket_idstringmarket_questionstringorder_hashstringpricenumberqualifying_labelstringsidestringsize_usdnumbertrader_addressstring | nullnullabletrader_usernamestring | nullnullableDelete Whale Radar alert config#
https://polyanna.app/api/v1/whales/configDeletes the current Pro user's Whale Radar alert config.
Parameters
No parameters.
Response
204Successful Response401Authentication required403Pro subscription required422Validation ErrorGet Whale Radar alert config#
https://polyanna.app/api/v1/whales/configReturns the current Pro user's Whale Radar alert config, if one exists.
Parameters
No parameters.
Response
200Successful Response401Authentication required403Pro subscription required422Validation ErrorResponse body
categoriesstring[]optionaldirectionsstring[]optionalemail_enabledbooleanoptionalenabledbooleanoptionalmin_usdnumberoptionalqualifying_labelsstring[]optionalspecific_walletsstring[]optionaltelegram_enabledbooleanoptionaluser_idstringwebhook_enabledbooleanoptionalUpsert Whale Radar alert config#
https://polyanna.app/api/v1/whales/configCreates or updates the current Pro user's Whale Radar alert config.
Parameters
No parameters.
Response
200Successful Response401Authentication required403Pro subscription required422Validation ErrorResponse body
categoriesstring[]optionaldirectionsstring[]optionalemail_enabledbooleanoptionalenabledbooleanoptionalmin_usdnumberoptionalqualifying_labelsstring[]optionalspecific_walletsstring[]optionaltelegram_enabledbooleanoptionaluser_idstringwebhook_enabledbooleanoptionalList curated Whale Radar showcase alerts#
https://polyanna.app/api/v1/whales/showcaseReturns the public curated Whale Radar reveal section with wallet-safe redacted payloads.
Parameters
No parameters.
Response
200Successful Response422Validation ErrorResponse body
itemsWhaleShowcaseAudienceItem[]Array of objects
API 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.