Tracker Tutorial: Smart Money Discovery to Automated Alerts

A complete workflow for finding top traders on Polymarket, building organized watch lists, and setting up alerts — from leaderboard discovery through copy trading.

Overview

The bullpen tracker command is the unified entry point for: - Tracking individual Polymarket addresses - Organizing tracked traders into wallet groups - Bookmarking markets to your watchlist - Configuring trade and comment alerts - Monitoring a live feed of tracked trader activity

Step 1: Find Smart Money on the Leaderboard

Before tracking anyone, use the leaderboard to find addresses worth following.

# Top all-time traders (default: top 25)
bullpen polymarket data leaderboard

# Filter by time period
bullpen polymarket data leaderboard --period week
bullpen polymarket data leaderboard --period day --limit 10
bullpen polymarket data leaderboard --period month

# Advanced Bullpen-indexed filters
bullpen polymarket data leaderboard --time-period 90d --sort copyability --hide-farmers
bullpen polymarket data leaderboard --search <NAME_OR_ADDRESS> --badge hot --risk-tier low

# JSON output for scripting (pipe to jq, etc.)
bullpen polymarket data leaderboard --output json
bullpen polymarket data leaderboard --period week --output json

Periods: day, week, month, all (default) Advanced periods: 1d, 7d, 30d, 90d, all; advanced sorts include pnl, volume, win-rate, positions, copyability, newest.

The leaderboard returns trader addresses alongside P&L and volume. Copy any address you want to track.

Step 2: Create a Wallet Group (Optional but Recommended)

Create a group before tracking so you can assign addresses immediately.

# List existing groups
bullpen tracker groups

# Create a named group with an emoji
bullpen tracker groups create "Whales" --emoji "🐋"
bullpen tracker groups create "DeFi Smart Money" --emoji "🧠"

# Create without an emoji
bullpen tracker groups create "Top Weekly Traders"

# JSON output (captures group_id for scripting)
bullpen tracker groups --output json

The create command returns the new group's ID. Note it — you'll need it to assign addresses.

Step 3: Track Addresses

# Basic: track an address
bullpen tracker add 0x1234...abcd

# With a display name
bullpen tracker add 0x1234...abcd --nickname "Whale 1"

# With nickname and group assignment (verified: address_count shows 1 after add)
bullpen tracker add 0x1234...abcd --nickname "Whale 1" --group <GROUP_ID>

# With per-address notification settings
bullpen tracker add 0x1234...abcd --notify-trades true --trade-threshold 5000

# All options at once
bullpen tracker add 0x1234...abcd \
  --nickname "GCR" \
  --group <GROUP_ID> \
  --notify-trades true \
  --notify-comments true \
  --trade-threshold 1000

Note on --group: The --group flag on tracker add is the direct way to assign an address to a group at tracking time. This is the recommended path — it sets the group membership in a single command.

List and Update Tracked Addresses

# List all tracked addresses
bullpen tracker list

# Filter by group
bullpen tracker list --group <GROUP_ID>

# JSON output
bullpen tracker list --output json

# Update an existing tracked address (notifications — no --group flag)
bullpen tracker update 0x1234...abcd --notify-trades true --notify-comments true
bullpen tracker update 0x1234...abcd --trade-threshold 2000

# Stop tracking
bullpen tracker remove 0x1234...abcd

Step 4: Monitor the Trade Feed

# Feed from all tracked addresses (default: 20 results)
bullpen tracker feed

# More results
bullpen tracker feed --limit 50

# Paginate
bullpen tracker feed --limit 50 --page 2

# Filter to a specific group
bullpen tracker feed --group <GROUP_ID>

# Filter to a single address
bullpen tracker feed --address 0x1234...abcd

# Combine group filter with pagination
bullpen tracker feed --group <GROUP_ID> --limit 100

# JSON output
bullpen tracker feed --output json

Step 5: Manage Wallet Groups

# List all groups
bullpen tracker groups

# Create
bullpen tracker groups create "Smart Money" --emoji "💡"

# Rename or re-emoji an existing group
bullpen tracker groups edit <GROUP_ID> --name "Top Smart Money"
bullpen tracker groups edit <GROUP_ID> --emoji "🏆"
bullpen tracker groups edit <GROUP_ID> --name "Winners" --emoji "🥇"

# Delete a group (tracked addresses are NOT removed, just ungrouped)
bullpen tracker groups delete <GROUP_ID>           # prompts for confirmation
bullpen tracker groups delete <GROUP_ID> --confirm # skip prompt

# Toggle notifications for every address in a group at once
bullpen tracker groups notify <GROUP_ID> on
bullpen tracker groups notify <GROUP_ID> off

# Add existing tracked addresses to a group (without re-tracking)
bullpen tracker groups add-address <GROUP_ID> 0x1234...abcd 0x5678...ef01

# Remove addresses from a group (they remain tracked, just ungrouped)
bullpen tracker groups remove-address <GROUP_ID> 0x1234...abcd

Step 6: Share and Import Groups

Groups can be shared with other Bullpen users via a share code.

# Generate a share code for your group
bullpen tracker groups share <GROUP_ID>

# Import someone else's group using their share code
bullpen tracker groups import <SHARE_CODE>

# Browse Bullpen-curated groups (pre-built lists of notable traders)
bullpen tracker groups curated

# Import a curated group by its ID
bullpen tracker groups curated import <GROUP_ID>

# JSON output
bullpen tracker groups curated --output json

Step 7: Watchlist (Market-Level Tracking)

The watchlist bookmarks markets (by slug) so you can monitor price and activity — separate from address tracking.

# List watchlisted markets
bullpen tracker watchlist

# Add a market by slug
bullpen tracker watchlist add will-bitcoin-hit-100k
bullpen tracker watchlist add presidential-election-2028

# View details for a watchlisted market
bullpen tracker watchlist view will-bitcoin-hit-100k

# Remove from watchlist
bullpen tracker watchlist remove will-bitcoin-hit-100k

# JSON output
bullpen tracker watchlist --output json

The watchlist is server-side and syncs across devices.

Step 8: Configure Alerts

Trade Alerts

Receive notifications when tracked traders execute trades matching your criteria.

# View current trade alert config
bullpen tracker alerts trade

# Set a trade alert (only from tracked addresses, minimum $5000 trades)
bullpen tracker alerts trade set --tracked-only --min-trade-size 5000

# Filter by action (Buy or Sell)
bullpen tracker alerts trade set --action Buy --min-trade-size 1000

# Filter by price range (e.g. only high-conviction bets)
bullpen tracker alerts trade set --min-share-price 0.70

# Filter by trader quality thresholds
bullpen tracker alerts trade set \
  --min-pnl 10000 \
  --min-volume 50000 \
  --min-predictions 20

# Filter by minimum position value
bullpen tracker alerts trade set --min-position-value 5000

# Exclude specific categories
bullpen tracker alerts trade set --exclude-category sports --tracked-only

# Remove the trade alert
bullpen tracker alerts trade delete

Comment Alerts

Receive notifications when commenters matching your criteria post.

# View current comment alert config
bullpen tracker alerts comment

# Alert on comments from high-PnL traders only
bullpen tracker alerts comment set --min-pnl 100000 --tracked-only

# Filter by commenter quality
bullpen tracker alerts comment set \
  --min-pnl 50000 \
  --min-volume 100000 \
  --min-predictions 50

# Filter by position size of the commenter
bullpen tracker alerts comment set --min-position-size 10000

# Remove the comment alert
bullpen tracker alerts comment delete

Smart Alerts

Automated alerts driven by Bullpen's smart money detection — no manual address tracking required.

# View current smart alert settings
bullpen tracker alerts smart

# Enable smart money alerts
bullpen tracker alerts smart --smart-money true

# Enable top trader alerts
bullpen tracker alerts smart --top-traders true

# Enable new wallet alerts (new addresses making large trades)
bullpen tracker alerts smart --new-wallets true

# Set preferred categories (comma-separated)
bullpen tracker alerts smart --categories crypto,politics

# Configure everything at once
bullpen tracker alerts smart \
  --smart-money true \
  --top-traders true \
  --new-wallets true \
  --categories crypto,politics,economics

# JSON output
bullpen tracker alerts smart --output json

Complete Workflow: Leaderboard to Automated Monitoring

# 1. Create a group for top weekly traders
bullpen tracker groups create "Weekly Top 5" --emoji "📈"
# Note the group_id from output

# 2. Pull the weekly leaderboard as JSON and extract top addresses
bullpen polymarket data leaderboard --period week --limit 5 --output json

# 3. Track each address into your group
bullpen tracker add 0xADDR1 --nickname "Trader A" --group <GROUP_ID> --notify-trades true --trade-threshold 2000
bullpen tracker add 0xADDR2 --nickname "Trader B" --group <GROUP_ID> --notify-trades true --trade-threshold 2000

# 4. Verify they were added
bullpen tracker list --group <GROUP_ID>

# 5. Watch their recent trades
bullpen tracker feed --group <GROUP_ID> --limit 50

# 6. Bookmark markets they're active in
bullpen tracker watchlist add will-bitcoin-hit-100k
bullpen tracker watchlist add fed-rate-cut-june

# 7. Set a trade alert for high-conviction buys from tracked addresses
bullpen tracker alerts trade set --tracked-only --min-trade-size 5000 --action Buy

# 8. Turn on smart alerts for broader coverage
bullpen tracker alerts smart --smart-money true --top-traders true --categories crypto,politics

# 9. Enable group-wide notifications
bullpen tracker groups notify <GROUP_ID> on

Scripting

JSON-capable tracker and Polymarket read commands support --output json. Combine with jq to automate workflows:

# Extract top 10 addresses from leaderboard
bullpen polymarket data leaderboard --period week --limit 10 --output json \
  | jq -r '.leaderboard[].address'

# List tracked addresses as JSON
bullpen tracker list --output json | jq '.tracked_addresses[] | {address, nickname, groups}'

# Get all group IDs and names
bullpen tracker groups --output json | jq '.groups[] | {id, name}'

# Feed from a group as JSON
bullpen tracker feed --group <GROUP_ID> --limit 100 --output json

Cross-References

• Research markets from feed results: See references/discovery-and-research.md
• Trade on signals: See references/trading.md
• Check your own positions: See references/portfolio-and-orders.md
• Automate with scripts: See references/scripting-and-automation.md
• Social feeds and comments: See references/social-and-signals.md