# 1️⃣2️⃣ HyperLiquid Builder Codes

HyperLiquid Builder Codes allow protocols and interfaces to incentivize perpetual trading volume on HyperLiquid. Fuul integrates as a registered builder to track and reward trades routed through your program — no custom event instrumentation required.

## What are Builder Codes?

HyperLiquid's builder code system lets ecosystem protocols tag trades they route through their interface. Fuul uses this tagging mechanism to track all trading activity routed through your builder — volume, fees, PnL, and order types are captured automatically for every trader.

## What you can incentivize

| Metric             | Description                                                   |
| ------------------ | ------------------------------------------------------------- |
| **Trading volume** | USD value of perpetual trades made during the period          |
| **Fees generated** | Trading fees attributed to trades routed through your builder |
| **PnL**            | Profit/loss per trader over the period                        |
| **Maker vs taker** | Distinguish volume by order type                              |

## How it works

Trade data is fetched daily using the builder code linked to your project. Activity from each day is processed and rewarded the following day.

{% hint style="info" %}
No contract address is required when setting up a HyperLiquid trigger. Fuul handles all data fetching automatically using the builder code associated with your project.
{% endhint %}

## Setup

Select **HyperLiquid Trade** as the trigger type when creating a conversion. Combine it with any payout type:

* **Variable** — reward traders as a % of their volume (e.g., 0.05% in POINTS)
* **Leaderboard** — rank traders by volume or PnL for a time-limited competition
* **Proportional pool** — distribute a fixed token pool proportionally to each trader's share of total volume

## Use cases

* Run affiliate and referral programs that reward partners for bringing in active traders
* Incentivize traders to route orders through your interface
* Run monthly trading competitions ranked by PnL or volume
* Distribute token rewards proportionally to the most active traders

{% hint style="warning" %}
Reach out at <ecosystem@fuul.xyz> to register your HyperLiquid builder code and connect it to your Fuul project before setting up the trigger.
{% endhint %}


---

# 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/core-concepts/trigger-integrations/hyperliquid.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.