💯Leaderboard Data

Retrieve and display leaderboard rankings for your incentive programs. Fuul provides three leaderboard types:

Leaderboard	SDK method	What it ranks
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.

Common parameters

All leaderboard methods support these filters:

Parameter	Type	Supported by	Description
user_identifier	string	All	Filter to a specific user (for individual rewards)
identifier_type	string	All	'evm_address', 'solana_address', 'sui_address', 'xrpl_address'
user_type	string	Payouts, Volume	'affiliate' or 'end_user' (omit for all)
fields	string	Payouts, Points	Comma-separated extra fields: 'tier,referred_volume,enduser_volume,enduser_revenue,referred_users'
conversion_external_ids	number[]	Payouts	Array of conversion IDs to filter by

Leaderboard responses are paginated. Use page and page_size (max 100 per page) to retrieve the full leaderboard — e.g., page 1 returns ranks 1–100, page 2 returns ranks 101–200, and so on.