Retrieve and display leaderboard rankings for your incentive programs. Fuul provides three leaderboard types:
Tokens
getPayoutsLeaderboard
Onchain token rewards earned
Points
getPointsLeaderboard
Point rewards earned
Volume
getVolumeLeaderboard
Trading/transaction volume generated
Leaderboard data is updated hourly. Recent conversions and payouts will appear within a maximum of one hour.
All leaderboard methods support these filters:
user_identifier
string
All
Filter to a specific user (for individual rewards)
identifier_type
'evm_address', 'solana_address', 'xrpl_address'
'evm_address'
'solana_address'
'xrpl_address'
user_type
Payouts, Volume
'affiliate' or 'end_user' (omit for all)
'affiliate'
'end_user'
fields
Payouts, Points
Comma-separated extra fields: 'tier,referred_volume,enduser_volume,enduser_revenue,referred_users'
'tier,referred_volume,enduser_volume,enduser_revenue,referred_users'
conversion_external_ids
number[]
Payouts
Array of conversion IDs to filter by
The leaderboard response returns only the top 100 users.
Last updated 2 hours ago