> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agg.market/llms.txt
> Use this file to discover all available pages before exploring further.

# Builder Codes

> Attribute the orders your app sends to a venue back to your own account

Venues let a front-end register its own identity so the order flow it sends can
be attributed back to it. Set one value per venue, per app, and AGG applies it
when your users trade.

## Configuring

Open the admin dashboard → select your app → **Settings → Builder Codes**. Each
venue has its own card showing the current value, when it was last updated, and
usage counters.

| Venue       | What you enter  | Format                                                 |
| ----------- | --------------- | ------------------------------------------------------ |
| Polymarket  | Builder code    | `0x` + 64 hex chars (bytes32). All-zero is rejected.   |
| Hyperliquid | Builder address | `0x` + 40 hex chars (EVM address). Stored lower-cased. |
| Predict.fun | Referral code   | Exactly 5 characters.                                  |

Only the **owner** of an app can set, update, or remove a value.

<Warning>
  These writes are JWT-only — an API key cannot change them, even with the
  `read_write` scope. You must be signed in to the admin dashboard.
</Warning>

## Where to get each value

**Polymarket** — create a builder profile at `polymarket.com/settings?tab=builder`.
The profile must be registered and set both its maker and taker fee rate to `0`,
or the code will be rejected when you save it.

**Hyperliquid** — the EVM address you want Hyperliquid to credit for the order
flow.

**Predict.fun** — the 5-character referral code from your Predict.fun account.
You need to deposit at least \$10 to Predict.fun before they will issue you one.

## What happens after you save

On **Polymarket** and **Hyperliquid** your value rides every order your users
place.

On **Predict.fun** there is no per-order field — the referral is attached to the
trader's Predict.fun account, once, on their first order through your app. It
only lands for traders who don't already have a referral on their account, so
rotating your code later affects new traders only.

A value that a venue rejects never blocks a trade — the order still goes
through.

## Removing

**Remove** on the venue card deletes the value. On Predict.fun this stops new
traders being referred but does not un-refer traders already attributed to you.