Órdenes TWAP en Hyperliquid: duración, subórdenes, slippage y API

En resumen: un TWAP de Hyperliquid parte una orden grande en subórdenes más pequeñas durante una ventana que eliges (de 5 minutos a 7 días). El exchange calcula el intervalo a partir del tamaño y la duración (mínimo 30 segundos), cada suborden tiene un slippage máximo del 3%, el nocional total mínimo es 100 $, y puedes aleatorizar el tamaño de cada tramo hasta ±20%. Si fallan fills, las siguientes pueden recuperar hasta 3× el tamaño normal — pero el TWAP puede terminar sin completar el tamaño pedido.

Qué es un TWAP en Hyperliquid

TWAP significa time-weighted average price (precio medio ponderado en el tiempo). En lugar de meter todo el tamaño de golpe con una market (y asumir slippage e impacto), Hyperliquid divide la orden padre en muchas órdenes hijas y las envía a lo largo del tiempo. Es el mismo concepto que usan mesas institucionales en CEX y otros perps; aquí es un tipo de orden de primera clase en la UI y en la API de exchange.

Convive con market, limit, stop, take, scale, chase y trailing stop en la guía de tipos de orden. Úsalo cuando el tamaño importa más que llenar en un clic: acumular o distribuir sin publicar un IOC enorme.

Reglas que importan de verdad

Parámetro	Valor (docs oficiales)
Duración	5 minutos a 7 días
Nocional mínimo total	100 $
Intervalo de subórdenes	Derivado de tamaño y duración; mínimo 30 segundos
Slippage máximo por suborden	3%
Randomize	Cada tramo ajustado al azar hasta ±20%
Tope de recuperación	Subórdenes posteriores ≤ 3× el tamaño normal
Upgrades de red	Como las market, no hacen fill en la ventana post-only del upgrade

Controles opcionales en la UI según la documentación: trigger price para que el TWAP solo arranque cuando el mark alcanza ese nivel, y max/min price para terminarlo si el mark toca ese stop.

Cómo Hyperliquid dimensiona los tramos

Durante la ejecución el TWAP persigue un objetivo de ejecución: (tiempo transcurrido / tiempo total) × tamaño total. Las subórdenes salen a un intervalo fijo calculado con tus inputs. Mucho tamaño en poco tiempo dispara hasta cada 30 segundos; poco tamaño en varios días espacia más los tramos.

Ejemplos oficiales:

• Orden de 10.000 $ en 1 hora → unas 121 subórdenes de ~83 $, cada 30 segundos.
• Orden de 10.000 $ en 4 días → unas 1.000 subórdenes de ~10 $, cada ~6 minutos.

Cada suborden tiene tope de slippage del 3%. Si la liquidez es fina y solo hay fills parciales, el TWAP se atrasará e intentará recuperar después — con el límite de 3×. Si fallan demasiados tramos, el padre puede acabar sin el 100% del tamaño. No lo trates como garantía de fill completo.

Cuándo usar TWAP frente a market, IOC o scale

• Market / IOC: necesitas inmediatez y aceptas impacto. Bien para nocional pequeño; caro en libros finos.
• Limit / scale: quieres precios maker y control de niveles. Mejor si puedes esperar y gestionar el book.
• TWAP: quieres un camino mecánico en el tiempo con presupuesto de impacto (3% por hijo). Útil para entradas/salidas de varias horas o días.

El TWAP no sustituye el control de riesgo. Combínalo con un apalancamiento sensato, conoce la distancia a liquidación y sigue el PnL real (comisiones + funding) en un tracker solo lectura como Hyperfolio.

Randomize: para qué sirve el ±20%

Con randomize activado, el tamaño de cada suborden se ajusta al azar hasta ±20% del tramo original. Tramos predecibles cada 30 segundos son fáciles de detectar. Aleatorizar el tamaño hace el footprint menos regular. El progreso medio sigue apuntando al mismo objetivo de ejecución.

API: colocar y cancelar un TWAP

Las acciones firmadas van a POST https://api.hyperliquid.xyz/exchange. Colocar:

{
  "action": {
    "type": "twapOrder",
    "twap": {
      "a": 0,
      "b": true,
      "s": "1.0",
      "r": false,
      "m": 60,
      "t": true
    }
  },
  "nonce": 1700000000000,
  "signature": { }
}

Significado según docs: a índice de activo (perps = índice en meta.universe; spot = 10000 + índice spot), b isBuy, s size, r reduceOnly, m minutos de duración, t randomize. Un ack correcto devuelve un twapId en ejecución (no un oid normal).

Cancelar con twapCancel: a = activo, t = ese twapId. En vaults o subcuentas, firma con la wallet master y usa vaultAddress. Los bots suelen usar una API / agent wallet que opera pero no retira.

Nota: la wire de TWAP en la documentación de exchange de Hyperliquid no incluye el campo builder de las órdenes normales. Si operas vía un frontend con builder fees, confirma cómo factura los fills del TWAP.

Ejemplo de planificación

Quieres comprar unos 50.000 $ de un perp mid-cap en una ventana nocturna sin un market agresivo.

1. Duración 6 horas (360 minutos), dentro de 5 min–7 días.
2. Nocional 50k $ > mínimo 100 $.
3. Espera intervalos cerca del suelo de 30 s si hacen falta muchos hijos, o más largos si el motor los espacia.
4. Activa randomize si te importa el footprint.
5. Opcional: trigger para arrancar solo si el mark baja a tu nivel, y max price para abortar si el mercado se dispara.
6. Después, concilia fills, fees y funding en Hyperfolio (solo lectura, sin claves) y usa el código HYPERFOLIO para 4% off en fees sobre los primeros 25M $ de volumen — ver la guía de referral.

Seguir los fills del TWAP en el portfolio

Cada fill hijo aparece como cualquier trade en userFills / historial. La identidad del padre vive en el canal twapId. Hyperfolio en app.hyperfolio.fun es una PWA gratis y solo lectura para wallets Hyperliquid: PnL, perps, Smart Money y multi-venue sin dar permisos de gasto. Útil tras un TWAP de varias horas cuando quieres PnL cerrado, fees y funding juntos.

FAQ

¿Cuál es el tamaño mínimo de un TWAP en Hyperliquid?

100 $ de nocional total, según la documentación oficial de order types.

¿Cuánto puede durar un TWAP?

De 5 minutos a 7 días.

¿Qué slippage permiten las subórdenes?

Máximo 3% por suborden.

¿Puede terminar sin llenar el 100%?

Sí. La recuperación está limitada a 3× el tamaño normal de suborden; el padre puede quedar incompleto.

¿Hacen fill durante un upgrade de red?

No. Como las market normales, no hacen fill en el periodo post-only del upgrade.

¿TWAP vs scale?

Scale coloca un ladder de límites en un rango de precio. TWAP envía hijos repartidos en el tiempo hacia un objetivo ponderado por tiempo, con tope de slippage del 3% por hijo.

Guías relacionadas

• Tipos de orden en Hyperliquid
• Slippage e impacto de precio
• Comisiones y tramos
• API / agent wallets

Abre Hyperfolio para trackear wallets tras un TWAP, y usa el código HYPERFOLIO en Hyperliquid para un 4% de descuento en fees sobre los primeros 25M $ de volumen.