⛓️Tokens

This article shows how to get onchain payout rewards - individually or in a leaderboard format

Projects can decide to show a leaderboard or a user profile on their own website.

Leaderboard data is not updated in real time due to performance considerations. Recent conversions and payouts will appear on the leaderboard within a maximum of one hour.

To get the leaderboard for your project use the getPayoutsLeaderboard method.

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

await Fuul.getPayoutsLeaderboard(
    { 
        currency_address: '0x12345',
        user_type: 'affiliate'
     }
);

currency_address is the address of the currency on the chain that the project is distributing payouts. Remember projects can payout different tokens for different conversions.

Use user_type = 'affiliate' for referred volume, and user_type = 'end_user' for converting user volume.

The leaderboard response will always return only the top 100 users

You can retrieve the tier and the volume information of users by adding them on the fields parameter as follows:

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

await Fuul.getPayoutsLeaderboard({ 
    currency_address: '0x12345',
    fields: 'tier,referred_volume,enduser_volume,enduser_revenue'
});

The referred_volume parameter will be returned in USD values.