Hyperliquid Builder Codes and Builder Fees

Direct answer

Hyperliquid builder codes let application builders receive a fee on fills they send for a user after the user approves a maximum fee for that builder. A code is only part of the question. The user also needs to see the builder address, maximum fee, example cost, whether the fee is additional to protocol fees, and how to revoke approval before signing anything.

How builder fees work

• The user must approve a maximum builder fee for a builder address before orders can include that builder fee.
• The approval action must be signed by the user's main wallet, not an agent or API wallet.
• A future order can include a builder parameter with the builder address and the fee amount, which cannot exceed the approved maximum.
• The official docs describe the fee amount in tenths of basis points, so a value of 10 equals 1 basis point.
• Each user can hold at most 10 active builder-code approvals at a time, and permissions can be revoked at any time.
• The currently approved maximum for any user-builder pair is publicly readable from the official API, so an approval is verifiable rather than hidden account state.

How revocation works

• Approval is account state, not a one-time signature: it stays active until the user revokes it or replaces it with a different maximum.
• The official docs state permissions can be revoked at any time; revocation is signed by the main wallet, the same way approval was.
• Setting a new maximum for the same builder replaces the old one, and a revoked builder can no longer attach fees to future orders.
• After revoking, the public approved-maximum read for that user-builder pair should reflect the change, which makes verification possible without trusting the app that requested approval.

For app builders

• A builder address must hold at least 100 USDC in perps account value before fees can be collected, per the official docs.
• Builder fees accrue to the builder and are claimed through the same claim flow the official docs use for referral rewards.
• The fee is set per order by the builder parameter, capped by both the user's approved maximum and the documented per-market caps.
• Nothing about a builder code changes execution, margin, liquidation, or funding; it only adds the disclosed fee to routed fills.

Disclosure checklist

• Builder address shown before approval.
• Maximum approved builder fee shown before approval.
• Example cost shown on a representative trade size.
• Clear statement about whether the fee is additional to protocol fees.
• Revocation path explained before the user approves anything.

What this page does not do

• It does not connect a wallet or ask for a signature.
• It does not approve a builder fee or route an order.
• It does not estimate a user-specific fee from private account data.
• It does not make trading cheaper, safer, or less risky.