Credits Overview

Polymarket pays users five kinds of credits. Each lands on Polygon as a batch token transfer, and PolyNode indexes all of them, for every wallet, from the first payout ever made: Polymarket’s public API exposes these only as a per-wallet activity feed with no totals, no cross-wallet queries and no aggregation. The credits endpoints add:

• Totals in one call — lifetime or any time window, per type (Wallet Credit Totals)
• Leaderboards — top earners per program per window across all wallets (Leaderboard)
• Global stats and series — program-wide payout volumes over time (Stats)
• A global feed — watch credits land across every wallet, filterable by size (Feed)
• Full filtering — amount bounds, amount sorting, token filter, time windows on everything
• Identity enrichment — usernames on leaderboards and event feeds, plus each wallet’s controlling EOA and other deployed Polymarket wallets on the totals endpoint

The index is built from on-chain distributor transfers, so it is a superset of Polymarket’s own activity ledger: batch program payouts match Polymarket’s feed exactly, and direct one-off payments from the distributor wallets (which Polymarket’s feed omits) are included as well. Amounts are USD strings (payouts settle in USDC.e historically and pUSD today; both are dollar-pegged and carried in the token field). New credits appear within about a minute of on-chain confirmation. Internal treasury/plumbing transfers between payout infrastructure addresses are excluded from all aggregate surfaces. All endpoints require your regular API key.

​

Credit types

Every credits endpoint accepts these values in type/types: types accepts a comma-separated set (types=maker_rebate,taker_rebate) or all.