🛠️Build Your Incentives Hub

This guide helps you plan what to integrate based on the features you want in your incentives hub. Each section points to the corresponding SDK documentation for implementation details.

Don't want to build anything? Use the No-Code Setup to launch a Fuul-hosted hub with zero development.

What do you need?

Referral tracking

If your program includes referrals, you need to track when users arrive via referral links and identify themselves.

What to integrate	Purpose
SDK Setup	Install and initialize the Fuul SDK
Tracking Referrals	Send pageview and wallet connection events to track the referral chain
Affiliate Links & Codes	Let affiliates generate tracking links and custom codes
Referral Codes	Let users accept referral codes directly

Leaderboards

If you want to display rankings on your site:

What to integrate	Purpose
Leaderboard Data — Tokens	Show top earners by onchain token payouts
Leaderboard Data — Points	Show top earners by points
Leaderboard Data — Volume	Show top users by trading or conversion volume

User rewards

If you want users to see their individual earnings:

What to integrate	Purpose
Individual Rewards — Tokens	Show a user's onchain token earnings
Individual Rewards — Points	Show a user's point balance
Referred Metrics	Show referral stats (volume, earnings, referred users)

Onchain claiming

If your program distributes token rewards, users need a way to claim them:

What to integrate	Purpose
Claiming Onchain Rewards	Build a claim button that lets users redeem their token rewards via smart contract

Social verification

If your program includes social actions:

What to integrate	Purpose
Verifying X Follows	Verify that a user has followed your account on X

Putting it together

A typical white-label hub combines several of these features. Here's what a full implementation looks like:

Hub feature	SDK features needed
Affiliate onboarding page	SDK Setup + Tracking Referrals + Affiliate Links & Codes
User dashboard	Individual Rewards (Tokens and/or Points) + Referred Metrics
Leaderboard page	Leaderboard Data (pick the relevant metric)
Claim rewards page	Claiming Onchain Rewards
Full hub	All of the above

For a working example, check out the Fuul SDK Next.js example — a complete implementation with RainbowKit wallet connection.

Explorer API

The Explorer API provides public listing endpoints for building discovery pages or aggregator integrations. These are the same endpoints that power the Fuul Explorer.

Endpoint	Description	Reference
GET /explorer/v1/listings/incentive-rewards	List incentive programs ranked by distributed payouts	View
GET /explorer/v1/listings/referral-rewards	List referral programs ranked by distributed payouts	View
GET /explorer/v1/projects/{projectId}	Get project details (name, description, links, thumbnail)	View
GET /explorer/v1/projects/{idOrSlug}/users-count	Get total user count for a project	View