Polymarket Analytics APIpolymarketanalytics.com ↗

"""Walkthrough: Polymarket Analytics SDK — bounded, re-runnable; every call capped."""
from parse_apis.polymarket_analytics_trader_api import (
    PolymarketAnalytics,
    TradeSortField,
    TransferSortField,
    SortDirection,
    TraderNotFound,
)

client = PolymarketAnalytics()

# Fetch a trader's dashboard — rank, PnL, win rate in one call.
trader = client.traders.get(trader_id="0x1234567890abcdef1234567890abcdef12345678")
print(f"#{trader.rank} {trader.trader_name} — PnL: ${trader.overall_gain:,.2f}, Win rate: {trader.win_rate:.1%}")

# Browse the trader's recent positions (limit caps total items fetched).
for pos in trader.positions.list(limit=3):
    print(f"  Position: {pos.event_title} | PnL: ${pos.overall_gain_usd}")

# Fetch recent trades sorted by value descending.
for trade in trader.trades.list(sort_by=TradeSortField.VALUE, sort_desc=SortDirection.DESC, limit=3):
    print(f"  Trade: {trade.side} {trade.amount} @ {trade.price} on {trade.market_title}")

# Category performance breakdown — which tags is this trader best at?
cat = trader.categories.list(limit=1).first()
if cat:
    print(f"  Top category: {cat.tag}, rank #{cat.rank}, win rate {cat.win_rate:.1%}")

# Typed error handling for an unknown wallet.
try:
    client.traders.get(trader_id="0x0000000000000000000000000000000000000000")
except TraderNotFound as exc:
    print(f"Trader not found: {exc.trader_id}")

# Deposits and withdrawals sorted by timestamp.
for transfer in trader.transfers.list(sort_by=TransferSortField.BLOCK_TIMESTAMP, sort_desc=SortDirection.DESC, limit=3):
    print(f"  {transfer.tx_type}: ${transfer.amount_usd} at {transfer.block_timestamp}")

print("Exercised: traders.get / positions.list / trades.list / categories.list / transfers.list")