Testnet de Hyperliquid: guía 2026 (faucet, USDC de prueba, API y HyperEVM)

Resumen: la testnet de Hyperliquid está en app.hyperliquid-testnet.xyz. Para usar el faucet (1.000 USDC de prueba) la misma dirección tiene que haber depositado antes en mainnet. Los desarrolladores cambian la API de https://api.hyperliquid.xyz a https://api.hyperliquid-testnet.xyz; la HyperEVM de testnet usa el chain ID 998 (mainnet es 999). Saldos, aprobaciones y API wallets de testnet están totalmente separados de mainnet, y nada de lo que ganes ahí es real.

Para qué sirve la testnet de Hyperliquid

La testnet es una copia separada de Hyperliquid (libros de órdenes de HyperCore más HyperEVM) que funciona con fondos ficticios. Es el sitio adecuado para:

• Aprender la interfaz —tipos de orden, TP/SL, apalancamiento y modos de margen— sin arriesgar dinero
• Probar un bot, un script de la API en Python o una configuración de API wallet (agente) antes de ir a real
• Desplegar y probar contratos en la HyperEVM
• Ensayar la mecánica de una estrategia (colocar, cancelar, cerrar con reduce-only) de principio a fin

Para lo que no sirve: medir liquidez real, slippage o funding. Los libros de testnet son finos y los mueven otros testers, así que los fills y precios dicen poco de cómo se comportaría la misma orden en mainnet.

Testnet vs mainnet de un vistazo

	Mainnet	Testnet
App de trading	app.hyperliquid.xyz	app.hyperliquid-testnet.xyz
URL base de la API	https://api.hyperliquid.xyz	https://api.hyperliquid-testnet.xyz
Chain ID HyperEVM	999	998
JSON-RPC HyperEVM	https://rpc.hyperliquid.xyz/evm	https://rpc.hyperliquid-testnet.xyz/evm
Fondos	USDC real (vía bridge)	USDC ficticio del faucet
Cadena de firma	"Mainnet"	"Testnet"

Hemos comprobado ambos chain ID contra los RPC en vivo (eth_chainId devuelve 0x3e7 = 999 en mainnet y 0x3e6 = 998 en testnet).

Cómo conseguir USDC de testnet (el faucet)

El faucet oficial está en https://app.hyperliquid-testnet.xyz/drip. La regla de la documentación de Hyperliquid es sencilla:

1. Deposita primero en mainnet con la misma dirección. El faucet solo funciona para direcciones con historial de depósito en mainnet. (El depósito mínimo en mainnet es de 5 USDC; lo explicamos en la guía de depósitos y retiros.)
2. Conecta esa misma wallet a la app de testnet.
3. Abre la página drip y reclama. Las direcciones elegibles reciben 1.000 USDC ficticios para usar en testnet.

El requisito del depósito en mainnet existe para que los bots no vacíen el faucet. Aunque solo quieras curiosear la interfaz, necesitas ese depósito: no hay vía oficial para saltárselo.

¿Entras con email? Tu dirección de testnet es otra

Esto confunde a mucha gente. Si inicias sesión en Hyperliquid con email, Privy genera una dirección distinta para mainnet y para testnet. Tu depósito de mainnet queda en una dirección que la app de testnet no ve, y el faucet te rechaza. La solución documentada: exporta tu wallet de email desde mainnet, impórtala en una extensión como Rabby o MetaMask y conecta esa extensión a testnet. Trata la clave exportada como cualquier clave privada; en la guía de seguridad de wallets explicamos cómo guardarla.

Usar la API en testnet

Todas las peticiones documentadas funcionan en ambas redes; solo cambia la URL base. Una consulta de solo lectura en testnet, sin claves:

curl -s -X POST https://api.hyperliquid-testnet.xyz/info \
  -H "Content-Type: application/json" \
  -d '{"type":"clearinghouseState","user":"0xTuDireccion"}'

En el SDK oficial de Python las URLs son constantes, así que cambiar de red es un argumento:

from hyperliquid.info import Info
from hyperliquid.utils import constants

info = Info(constants.TESTNET_API_URL, skip_ws=True)   # https://api.hyperliquid-testnet.xyz
print(info.user_state("0xTuDireccion")["marginSummary"])

# cuando vayas a dinero real:
# info = Info(constants.MAINNET_API_URL, skip_ws=True)  # https://api.hyperliquid.xyz

Por debajo, las firmas dependen de la red. El SDK firma las acciones L1 (órdenes, cancelaciones) con un phantom agent de origen "a" en mainnet y "b" en testnet, y las acciones firmadas por el usuario (transferencias, retiros, aprobación de agentes) llevan hyperliquidChain: "Mainnet" o "Testnet". Una firma hecha para una red no vale en la otra, lo que es una buena red de seguridad: un script de prueba no puede lanzar una orden real por olvidar cambiar una línea, siempre que la URL y el flag de firma coincidan.

API wallets y nonces van por red

Como la testnet es un estado de cadena aparte, una API wallet aprobada en mainnet no existe en testnet y viceversa. Aprueba un agente específico en testnet, prueba con él y luego aprueba uno nuevo en mainnet. Los rate limits siguen las mismas reglas publicadas en ambas (por ejemplo, las peticiones REST comparten un presupuesto de peso de 1.200 por minuto e IP), así que la testnet también sirve para ver si tu bot hace demasiadas llamadas.

Los parámetros de mercado pueden cambiar en testnet

No des por hecho que un mercado se comporta igual en las dos redes. Al consultar el endpoint meta de cada API en octubre de 2026, mainnet listaba 234 mercados perp y testnet 212, y el apalancamiento máximo de SOL era 20x en mainnet frente a 10x en testnet (BTC estaba en 40x en ambas). Lee siempre meta de la red en la que operas y revisa decimales de tamaño y límites de apalancamiento antes de pasar un bot a real. Cómo se traduce el apalancamiento en distancia a liquidación lo vemos en la guía de apalancamiento.

HyperEVM en testnet

Para añadir la HyperEVM de testnet a una wallet, usa el chain ID 998 y el RPC https://rpc.hyperliquid-testnet.xyz/evm. HYPE es el token de gas nativo y tiene 18 decimales en ambas redes. Igual que en mainnet, HYPE pasa de HyperCore a HyperEVM enviándolo a la dirección de sistema 0x2222222222222222222222222222222222222222. No hay frontend oficial de la HyperEVM: todo va por JSON-RPC, tu propio frontend o herramientas EVM estándar.

Checklist sensato para pasar de testnet a mainnet

1. Recorre el flujo completo en testnet: colocar, modificar y cancelar órdenes, añadir TP/SL y cerrar con reduce-only.
2. Registra cada respuesta y error; comprueba que tu código gestiona rechazos (tick size, tamaño mínimo, margen).
3. Cambia la URL base y el flag de firma de mainnet a la vez, y aprueba una API wallet nueva en mainnet.
4. Empieza con tamaño pequeño en mainnet: la liquidez de testnet esconde el slippage real.
5. Sigue la wallet real desde el primer día para ver el PnL verdadero tras comisiones y funding.

Sigue lo real con Hyperfolio

El PnL de testnet es dinero de juguete; el de mainnet es el que cuenta. Hyperfolio es una PWA gratuita y de solo lectura: pegas una dirección de Hyperliquid en mainnet y ves posiciones, PnL realizado y no realizado, funding y comisiones, sin claves ni registro, así que puede vigilar con seguridad la wallet con la que opera tu bot (mira por qué no hacen falta API keys). Y si todavía no tienes código de referido en mainnet, el código HYPERFOLIO te da un 4% de descuento en comisiones (cómo funciona).

Preguntas frecuentes

¿La testnet de Hyperliquid es gratis?

Sí. La testnet no cuesta nada y el USDC del faucet es ficticio. El único requisito para reclamar el faucet es un depósito previo en mainnet desde la misma dirección.

¿Por qué el faucet dice que no soy elegible?

Casi siempre porque la dirección conectada nunca depositó en mainnet; lo más habitual es un usuario con login por email cuya dirección Privy de testnet es distinta de la de mainnet. Exporta la wallet de mainnet, impórtala en Rabby o MetaMask y conéctala a testnet.

¿Cuánto da el faucet?

1.000 USDC ficticios por dirección elegible, según la documentación oficial.

¿Puedo pasar fondos de testnet a mainnet?

No. Los activos de testnet no tienen valor y no se pueden mover ni retirar a mainnet.

¿Cuál es la URL de la API de testnet de Hyperliquid?

https://api.hyperliquid-testnet.xyz (mainnet es https://api.hyperliquid.xyz). En el SDK de Python, constants.TESTNET_API_URL.

¿Cuál es el chain ID de la HyperEVM en testnet?

998, con RPC https://rpc.hyperliquid-testnet.xyz/evm. Mainnet es el chain ID 999.

¿Los resultados en testnet predicen los de mainnet?

Solo la mecánica. Liquidez, slippage, funding e incluso algunos parámetros de mercado cambian, así que valida en mainnet con tamaño pequeño.