BYOL Overview

Documentation Index

Fetch the complete documentation index at: https://polynode.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

BYOL (Bring Your Own Leaderboard) lets you build a custom Polymarket leaderboard from any set of wallets you choose. Add the wallets you care about, and polynode continuously indexes their P&L, volume, and global rank across every time period and category that Polymarket tracks.

​

How it works

1. Add wallets you want to track via the API
2. polynode indexes every wallet across all time periods and categories in the background (~30 min refresh cycle)
3. Query your leaderboard by time period, category, or get everything at once
4. Each API key has its own private wallet set. Your wallets and leaderboard are completely isolated from other users.

​

What you get back

Every wallet in your set is indexed across: 4 time periods matching Polymarket’s leaderboard:

• day (Today)
• week (Weekly)
• month (Monthly)
• all (All time)

9 categories:

• overall politics sports crypto finance tech weather culture mentions

2 sort options:

• pnl (Profit/Loss)
• vol (Volume)

The response fields match Polymarket’s leaderboard format exactly: rank, proxyWallet, userName, xUsername, verifiedBadge, vol, pnl, profileImage. We add localRank to show where each wallet ranks within your custom set.

​

Limits

• 5,000 wallets max per API key
• Free tier keys cannot access BYOL. Any paid tier has full access.
• Adding a wallet that’s already in your set doesn’t count toward the limit

​

Endpoints