📊Affiliate Dashboard

The affiliate dashboard is the affiliate-facing section of your incentives hub. It gives affiliates a real-time view of their performance, earnings, and referral activity.

Aggregate stats

Show an overview of the affiliate's activity across the program:

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

const stats = await Fuul.getAffiliateStats({
  userIdentifier: '0x1234...',
  identifierType: 'evm_address',
  thisMonth: true // or provide from/to for a custom date range
});

Field	Description
total_earnings	Rewards earned, per currency
referred_volume	USD volume generated by referred users
referred_revenue	Revenue attributed to referred users
referred_users	Total unique users referred

New traders

Show users who converted for the first time via this affiliate:

const newTraders = await Fuul.getAffiliateNewTraders({
  userIdentifier: '0x1234...',
  identifierType: 'evm_address',
  thisMonth: true
});
// Returns: [{ referrer_identifier, total_new_traders }]

Per-referral breakdown

Show volume and earnings for each individual referred user:

const breakdown = await Fuul.getPayoutsByReferrer({
  user_identifier: '0x1234...',
  user_identifier_type: 'evm_address',
});

Leaderboard position

Show where the affiliate ranks among all affiliates in the program:

const leaderboard = await Fuul.getPayoutsLeaderboard({
  userIdentifier: '0x1234...',
  identifierType: 'evm_address',
  userType: 'affiliate'
});

Referral tree (multi-level programs)

For multi-level referral programs, display the affiliate's full downline:

// GET /v1/affiliate-portal/referral-tree

All stats endpoints support filtering by specific conversion IDs using conversionExternalIds, so affiliates can drill into performance per incentive program.