Builder Codes

Builder code attribution for integrators and front-end builders.

Overview

Builder codes let integrators attribute trading volume to their interface. In the API, a builder code is represented by the integrator's assigned builder_code_address, a 0x EVM address used for attribution and future fee sharing. Hypercall venue trading fees are currently disabled, so builder codes do not generate revenue today.

When venue fees are enabled in the future, builder codes are expected to earn a share of trading fees generated by users who trade through their interface.

Hyperliquid Perpetual Orders

Hypercall's production Hyperliquid builder address: 0x406ceBfC7063e55761007D1C4b66B29308016602.

This address identifies perp orders sent through Hypercall's TEE route (the app default, opt-in over the API) on Hyperliquid. The builder fee attached to those orders is 0%. The trading account must approve this builder address on Hyperliquid before an order can use it: in the app this is the one-time Enable trading step, a manager-wallet transaction that calls approveZeroFeeBuilder on your Hypercall account contract. A 0% approval cannot later be used to charge a nonzero fee. See Enable trading. This Hyperliquid approval is separate from builder codes used for attribution on Hypercall's options venue.

How It Works

1. Apply for builder attribution
2. Integrate the assigned builder_code_address into your trading interface
3. Attribute trading volume now
4. Earn revenue share after venue fees are enabled

Builder fees will come from the protocol's share after venue fees are enabled. Users pay the same fees regardless of builder code.

Integration

REST API

Include your assigned builder code address in order requests:

{
  "wallet": "0x...",
  "symbol": "ETH-20250228-3500-C",
  "side": "Buy",
  "size": "1.0",
  "price": "150.00",
  "builder_code_address": "0x1234567890abcdef1234567890abcdef12345678",
  "nonce": 1,
  "signature": "0x..."
}

WebSocket

Include the builder code address in PlaceOrder messages:

{
  "type": "PlaceOrder",
  "wallet": "0x...",
  "symbol": "ETH-20250228-3500-C",
  "side": "Buy",
  "size": "1.0",
  "price": "150.00",
  "nonce": 1,
  "signature": "0x...",
  "builder_code_address": "0x1234567890abcdef1234567890abcdef12345678"
}

Bulk Orders

Builder codes work with bulk endpoints. Include builder_code_address in each order object.

Tracking & Payouts

• Attribution: Recorded on fills and returned by fill APIs
• Current revenue: 0 while trading fees are disabled
• Future payouts: Planned in USDC after venue fees are enabled

Applying

Builder codes are available now. To apply, reach out on Twitter @synapseprotocol with:

• Project name and description
• Website or GitHub
• Expected integration timeline

Terms

• Builder codes are non-transferable
• Wash trading or self-referral is prohibited
• Hypercall reserves the right to revoke codes for abuse
• Revenue share rates may change with 30 days notice

Example

A trading aggregator routing $100M daily volume after venue fees are enabled:

Metric	Value
Daily volume	$100,000,000
Fee rate	0.05%
Total fees	$50,000
Builder share (50%)	$25,000/day