POLYANNA

POLYANNA

Search traders, compare leaderboard variants, and inspect profile analysis from public on-chain market activity.

Data sourced from on-chain activity

Explore

  • Leaderboards
  • Copyable Traders
  • Whale Radar
  • Smart-Money Signals
  • Pricing

Learn

  • Blog
  • Docs
  • API Reference
  • FAQ

Legal

  • Privacy Policy
  • Terms of Service

Polyanna — Polymarket Intelligence

Getting Started

  • Overview
  • How Polyanna Works

Features

  • Leaderboards
  • Trader Profiles
  • Analysis Methodology
  • Whale Radar
  • Smart-Money Signals
  • Platform Insights
  • Trade Alerts

Metrics

  • PnL
  • Risk Metrics
  • Bot Detection

Reference

  • API Reference
    • Trader API
    • Leaderboards API
    • Whale Radar API
    • Smart-Money API
  • Data Sources
  • Glossary

Smart-Money API

Endpoints for reading Smart-Money Signals, current highlights, historical snapshots, and market-level signal analysis.

All endpoint paths below start with /v1. See the general API page for authentication, rate limits, retry behavior, and shared error handling.

Endpoints#

Get Smart-Money Signals#

GEThttps://polyanna.app/api/v1/smart-money
Optional auth

Returns Smart-Money Signals for a trader group. Anonymous and Free callers receive category concentration, wallet-safe current highlight, and teaser market rows. Pro callers receive full opportunity and consensus rows with trader entries.

Parameters

cohortSmartMoneyCohortquery

Smart-Money trader group to serve.

Response

200Successful Response
422Validation Error
503Smart-Money Signals are not available yet

Response body

categoriesSmartMoneyCategory[]optional
cohortSmartMoneyCohort
cohort_sizeinteger
computed_atstring
consensus_marketsSmartMoneyMarket[]optional
marketsSmartMoneyMarket[]optional
snapshot_datestring
weekly_pickSmartMoneyMarket | nulloptionalnullable

Get Smart-Money signal history#

GEThttps://polyanna.app/api/v1/smart-money/history
Authenticated

Returns the Pro-only weekly Smart-Money history for one trader group. The payload contains reduced category and market snapshots with diffs, previous opportunity rows with outcome context when available, and never includes trader identity.

Parameters

cohortSmartMoneyCohortquery

Smart-Money trader group to serve.

weeksintegerquery

Number of weekly Smart-Money history snapshots to return.

Response

200Successful Response
401Authentication required
403Pro subscription required
422Validation Error

Response body

cohortSmartMoneyCohort
performance_summarySmartMoneyPerformanceSummary | nulloptionalnullable
previous_signalsSmartMoneyPreviousSignal[]optional
snapshotsSmartMoneyHistoryWeek[]optional
weeksinteger

Get Smart-Money signal analysis#

GEThttps://polyanna.app/api/v1/smart-money/market/{market_id}
Authenticated

Returns the Pro-only Smart-Money signal analysis for one market and trader group, including market-level divergence and full trader position rows.

Parameters

market_idstringrequiredpath

Pattern: ^(0x)?[0-9a-fA-F]{1,128}$

cohortSmartMoneyCohortquery

Smart-Money trader group to serve.

Response

200Successful Response
401Authentication required
403Pro subscription required
404Smart-Money market detail not found
422Validation Error

Response body

categorystring
divergencenumber | nullnullable
market_idstring
market_price_yesnumber | nullnullable
market_questionstring
market_slugstring
n_nointeger
n_tradersinteger
n_yesinteger
pct_yes_by_usdnumber
total_usdnumber
tradersSmartMoneyTraderEntry[]optional

Get Smart-Money current highlight#

GEThttps://polyanna.app/api/v1/smart-money/weekly-pick
Optional auth

Returns the public Smart-Money current highlight. The payload includes market-level aggregate detail and excludes raw trader wallet identity.

Parameters

cohortSmartMoneyCohortquery

Smart-Money trader group to serve.

Response

200Successful Response
422Validation Error
503Smart-Money current highlight not yet generated

Response body

categorystring
divergencenumber | nullnullable
market_idstring
market_price_yesnumber | nullnullable
market_questionstring
market_slugstring
n_nointeger
n_tradersinteger
n_yesinteger
pct_yes_by_usdnumber
total_usdnumber

API Areas#

General API

Authentication, rate limits, retries, errors, and shared API behavior.

Trader API

Search traders, fetch public profiles, and read authenticated trader analytics.

Leaderboards API

Discover leaderboard variants and fetch a specific leaderboard by tab and period.

Whale Radar API

Read Whale Radar alerts, showcase rows, alert details, and Pro notification config.

Smart-Money API

Fetch Smart-Money Signals, weekly highlights, historical snapshots, and market-level signal analysis.

Previous
Whale Radar API
Next
Data Sources