Códigos de builder

Atribución mediante códigos de builder para integradores y desarrolladores de front-end.

Descripción general

Los códigos de builder permiten a los integradores atribuir el volumen de trading a su interfaz. En la API, un código de builder se representa mediante la builder_code_address asignada al integrador, una dirección EVM 0x que se utiliza para la atribución y el futuro reparto de comisiones. Las comisiones de trading del venue de Hypercall están desactivadas actualmente, por lo que los códigos de builder no generan ingresos hoy.

Cuando se activen las comisiones del venue en el futuro, se espera que los códigos de builder obtengan una parte de las comisiones de trading generadas por los usuarios que operen a través de su interfaz.

Órdenes de contratos perpetuos en Hyperliquid

Dirección de builder de Hyperliquid de Hypercall en producción: 0x406ceBfC7063e55761007D1C4b66B29308016602.

Esta dirección identifica las órdenes de perpetuos enviadas a través de la ruta TEE de Hypercall (la opción predeterminada en la app y opcional mediante la API) en Hyperliquid. La comisión de builder asociada a esas órdenes es del 0%. La cuenta de trading debe aprobar esta dirección de builder en Hyperliquid antes de que una orden pueda utilizarla: en la app, este es el paso único Activar trading, una transacción de la wallet de gestión que llama a approveZeroFeeBuilder en el contrato de su cuenta de Hypercall. Una aprobación del 0% no puede utilizarse posteriormente para cobrar una comisión distinta de cero. Consulte Activar trading. Esta aprobación en Hyperliquid es independiente de los códigos de builder utilizados para la atribución en el venue de opciones de Hypercall.

Cómo funciona

1. Solicite la atribución de builder
2. Integre la builder_code_address asignada en su interfaz de trading
3. Atribuya el volumen de trading desde ahora
4. Obtenga el reparto de ingresos una vez que se activen las comisiones del venue

Las comisiones de builder provendrán de la parte del protocolo una vez que se activen las comisiones del venue. Los usuarios pagan las mismas comisiones independientemente del código de builder.

Integración

API REST

Incluya la dirección de su código de builder asignado en las solicitudes de órdenes:

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

WebSocket

Incluya la dirección del código de builder en los mensajes PlaceOrder:

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

Órdenes masivas

Los códigos de builder funcionan con los endpoints masivos. Incluya builder_code_address en cada objeto de orden.

Seguimiento y pagos

• Atribución: se registra en los fills y la devuelven las APIs de fills
• Ingresos actuales: 0 mientras las comisiones de trading estén desactivadas
• Pagos futuros: previstos en USDC una vez que se activen las comisiones del venue

Solicitud

Los códigos de builder ya están disponibles. Para solicitarlos, contacte por Twitter @synapseprotocol indicando:

• Nombre y descripción del proyecto
• Sitio web o GitHub
• Plazo previsto de integración

Términos

• Los códigos de builder no son transferibles
• Se prohíbe el wash trading y la autorreferencia
• Hypercall se reserva el derecho de revocar códigos en caso de abuso
• Las tasas de reparto de ingresos pueden cambiar con un preaviso de 30 días

Ejemplo

Un agregador de trading que canaliza $100M de volumen diario una vez activadas las comisiones del venue:

Métrica	Valor
Volumen diario	$100,000,000
Tasa de comisión	0.05%
Comisiones totales	$50,000
Parte del builder (50%)	$25,000/día