⛓️Tokens

Retrieve the onchain token payouts leaderboard using the getPayoutsLeaderboard method.

import { Fuul } from '@fuul/sdk';

await Fuul.getPayoutsLeaderboard({
  currency_address: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
  user_type: 'affiliate',
});
Parameter
Required
Description

currency_address

Yes

Token contract address on the payout chain

user_type

No

'all', 'affiliate', or 'end_user'

fields

No

Extra fields: 'tier,referred_volume,enduser_volume,enduser_revenue'

circle-info

Projects can pay out different tokens for different conversions. Use the currency_address of the specific token you want to query.

circle-info

No chain_id is required β€” the SDK automatically uses the chain where the program is hosted.

With extra fields

import { Fuul } from '@fuul/sdk';

await Fuul.getPayoutsLeaderboard({
  currency_address: '0xA0b86...',
  fields: 'tier,referred_volume,enduser_volume,enduser_revenue',
});
circle-info

The referred_volume values are returned in USD.

circle-info

The leaderboard response returns only the top 100 users.

Last updated