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 launches with trading fees disabled, so builder codes do not generate revenue on day one.

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.

How It Works

1. Apply for builder attribution
2. Integrate the assigned builder_code_address into your trading interface
3. Attribute trading volume at launch
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
• Launch 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

Approval timing depends on launch operations.

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