Builder Codes

面向集成方和前端构建者的 Builder Code 归因。

概述

Builder Code 让集成方能够将交易量归因到其界面。在 API 中，Builder Code 由集成方被分配的 builder_code_address 表示，这是一个 0x 开头的 EVM 地址，用于归因和未来的手续费分成。Hypercall 交易场所的交易手续费目前处于关闭状态，因此 Builder Code 目前不产生收入。

未来启用交易场所手续费后，Builder Code 预计将从通过其界面交易的用户所产生的交易手续费中获得一定分成。

Hyperliquid 永续合约订单

Hypercall 的生产环境 Hyperliquid builder 地址： 0x406ceBfC7063e55761007D1C4b66B29308016602。

该地址用于标识通过 Hypercall TEE 路由（应用默认使用，API 中需主动选择启用）发送至 Hyperliquid 的永续合约订单。这些订单附带的 builder 手续费为 0%。交易账户必须先在 Hyperliquid 上批准该 builder 地址，订单才能使用它：在应用中，这是一次性的 Enable trading 步骤，即由管理者钱包发起的一笔交易，调用您 Hypercall 账户合约上的 approveZeroFeeBuilder。0% 的批准之后无法被用于收取非零手续费。参见 Enable trading。此 Hyperliquid 批准与 Hypercall 期权交易场所上用于归因的 Builder Code 相互独立。

工作原理

申请 Builder 归因
集成将分配的 builder_code_address 集成到您的交易界面
归因即刻开始归因交易量
收益在启用交易场所手续费后获得收入分成

启用交易场所手续费后，Builder 费用将来自协议的份额。无论是否使用 Builder Code，用户支付的手续费都相同。

集成

REST API

在订单请求中包含您被分配的 Builder Code 地址：

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

WebSocket

在 PlaceOrder 消息中包含 Builder Code 地址：

{
  "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"
}

批量订单

Builder Code 适用于批量下单端点。请在每个订单对象中包含 builder_code_address。

追踪与支付

归因：记录在成交记录中，并通过成交 API 返回
当前收入：交易手续费关闭期间为 0
未来支付：计划在启用交易场所手续费后以 USDC 支付

申请

Builder Code 现已开放申请。如需申请，请通过 Twitter @synapseprotocol 联系我们，并提供：

项目名称及简介
网站或 GitHub
预计集成时间表

条款

Builder Code 不可转让
禁止对敲交易或自我推荐
Hypercall 保留因滥用行为撤销 Builder Code 的权利
收入分成比例可能变更，并将提前 30 天通知

示例

某交易聚合器在启用交易场所手续费后，每日路由 1 亿美元交易量：

指标	数值
日交易量	$100,000,000
手续费率	0.05%
手续费总额	$50,000
Builder 分成（50%）	$25,000/天

概述​

Hyperliquid 永续合约订单​

工作原理​

集成​

REST API​

WebSocket​

批量订单​

追踪与支付​

申请​

条款​

示例​

概述