Skip to main content
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. Only the owner of an app can set, update, or remove a value.

​
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 (polymarket) and Hyperliquid (hyperliquid), AGG includes your builder identity when it submits that user’s order to the venue. This is venue attribution. It is not appFeeBips, and it does not change the fee on the quote. Self-custody Hyperliquid asks the user’s wallet once for the builder-fee approval. See Signing. On Predict.fun (predict) 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.

​
Hyperliquid referral code (optional)

The Hyperliquid card also takes your Hyperliquid referral code, next to the builder address. Hyperliquid only issues one to an account with $10k of trading volume. We attach it once to each of your users’ Hyperliquid accounts: the user gets Hyperliquid’s referral fee discount, and your account earns Hyperliquid’s referral share of their fees, which you claim on Hyperliquid.
  • Accounts that are already referred by anyone — some wallets attach their own code — keep their existing referrer. Hyperliquid does not allow changing it.
  • The account must have received a deposit before the code can attach. If it can’t attach yet, we try again on the user’s next order.
  • Codes are case-sensitive. A code Hyperliquid doesn’t recognise shows as an error on the card and is paused for an hour; trading is never affected. Once you register that code on Hyperliquid, your users are picked up again automatically.
  • Self-custody: the referral is one extra hl_l1_action signature request (purpose: "hl_referral", optional: true), parked after the order’s and signed by the same key (your agent key, if you use one). It is asked for at most once per user, and only for users who can still be referred. It is optional: if your signer declines it or it expires, skip it and post the rest — fillSelfCustody in @agg-build/sdk does this for you — and the trade goes through as normal. The user is asked again on their next trade.

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