Hyperliquid Builder Codes vs Referral Codes: What's the Difference?

A single line of code determines whether you save money on fees, or whether an API developer takes a cut. You need to know which one is attached to your account.

Because Hyperliquid is built as a developer-friendly L1, it features two distinct monetization mechanics: the referral program for user acquisition, and the builder program for third-party application development. Confusing the two is a common mistake for new users trying to optimize their trading costs.

Referral Codes: The Trader's Version

Referral codes are designed exclusively for end users. When you bind a referral code to your Hyperliquid account, you receive a permanent 4% discount on all your taker trading fees. The referrer (the entity whose link you used) receives a 10% share of the fees you pay.

This is a mutually beneficial arrangement. As a trader, you want a referral code active on your account at all times to minimize execution drag. You can calculate the exact savings to see the compounding effect of this discount over time.

Builder Codes: The Developer's Version

Builder codes are entirely different. They are used by developers who create third-party trading terminals, mobile apps, or automated bots that interact with the Hyperliquid API. When a user trades through their custom interface, the developer appends their "builder code" to the API request.

The builder code instructs the protocol to route a portion of the trading fees (typically 10%) to the developer as compensation for building the tool. Unlike referral codes, a builder code provides zero fee discount to the trader executing the order.

Can You Stack Both? (The Answer Is No)

This is where the friction occurs. Hyperliquid's protocol rules stipulate that a single trade cannot be subject to both a referral fee split and a builder fee split simultaneously. If an order is submitted with a builder code, the builder gets the fee share, and the user's referral discount is nullified for that specific trade.

If you are actively trading via the native Hyperliquid interface, this is not an issue—your referral discount applies perfectly. But if you use a third-party aggregator or mobile app, you may be unknowingly paying full fees because the app is injecting its builder code.

How to Check Which Code Is Active on Your Account

To ensure you are receiving your 4% discount, log into the official Hyperliquid web app and navigate to the "Referrals" section under your account settings. It will clearly display whether you have successfully bound a referrer to your wallet.

If you are using a custom trading bot, ensure your API requests are not injecting a generic builder code unless you specifically intend to support the developer of that code.