# 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.

{% hint style="info" %}
**Don't want to build anything?** Use the [No-Code Setup](broken://pages/3ZluGciHtTpNp3sKd98C) to launch a Fuul-hosted hub with zero development.
{% endhint %}

## 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](/developer-guide/getting-started-with-fuul-web-sdk.md)               | Install and initialize the Fuul SDK                                    |
| [Tracking Referrals](/developer-guide/tracking-referrals-in-your-app.md)         | Send pageview and wallet connection events to track the referral chain |
| [Affiliate Links & Codes](/developer-guide/creating-affiliate-links-or-codes.md) | Let affiliates generate tracking links and custom codes                |
| [Referral Codes](/developer-guide/referral-codes.md)                             | Let users accept referral codes directly                               |

### Leaderboards

If you want to display rankings on your site:

| What to integrate                                                                | Purpose                                        |
| -------------------------------------------------------------------------------- | ---------------------------------------------- |
| [Leaderboard Data — Tokens](/developer-guide/getting-leaderboard-data/tokens.md) | Show top earners by onchain token payouts      |
| [Leaderboard Data — Points](/developer-guide/getting-leaderboard-data/points.md) | Show top earners by points                     |
| [Leaderboard Data — Volume](/developer-guide/getting-leaderboard-data/volume.md) | 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](/developer-guide/getting-individual-rewards/tokens.md) | Show a user's onchain token earnings                   |
| [Individual Rewards — Points](/developer-guide/getting-individual-rewards/points.md) | Show a user's point balance                            |
| [Referred Metrics](/developer-guide/referred-metrics.md)                             | 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](/developer-guide/claiming-onchain-rewards.md) | 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](/core-concepts/trigger-integrations/quests-and-social/verifying-x-follows.md) | 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                                             |

{% hint style="success" %}
For a working example, check out the [Fuul SDK Next.js example](https://github.com/fuul-app/fuul-sdk-nextjs-example/tree/main) — a complete implementation with RainbowKit wallet connection.
{% endhint %}

## 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](https://fuul.readme.io/reference/getincentiverewardslisting) |
| `GET /explorer/v1/listings/referral-rewards`       | List referral programs ranked by distributed payouts      | [View](https://fuul.readme.io/reference/getreferralrewardslisting)  |
| `GET /explorer/v1/projects/{projectId}`            | Get project details (name, description, links, thumbnail) | [View](https://fuul.readme.io/reference/getprojectexplorerdata)     |
| `GET /explorer/v1/projects/{idOrSlug}/users-count` | Get total user count for a project                        | [View](https://fuul.readme.io/reference/getprojectuserscount)       |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fuul.xyz/developer-guide/build-your-incentives-hub.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.