Cómo Exportar el Historial de Trades de Hyperliquid (CSV) para Impuestos y Análisis

Respuesta rápida: no necesitas un servicio de pago para exportar tu historial de trades de Hyperliquid. La API pública del exchange devuelve todos los fills, pagos de funding y transferencias de cualquier wallet, y la pestaña Historial de la app incluye botones de exportación CSV para trades y funding recientes. La pega: la interfaz solo exporta lo que tiene cargado y la API limita cada respuesta a 2.000 registros. Si quieres tu historial completo sin escribir código, Hyperfolio te muestra el PnL, las comisiones y el funding desglosados de cualquier dirección de Hyperliquid al instante — gratis y sin registro.

Se acerca la declaración, tu gestor te pide "los informes de Hyperliquid" y tú tienes 4.000 trades repartidos entre perps, spot y una wallet que apenas recuerdas. Abres la app, pulsas exportar y consigues un CSV que cubre… un par de meses. En ese hueco se esconde tu PnL real.

Exportar el historial de Hyperliquid es el dolor más infravalorado del trading de perpetuos. El exchange es transparente — cada fill, pago de funding, depósito y retirada es dato público en cadena —, pero convertirlo en un archivo limpio y completo es otra historia. Esta guía recorre todos los métodos que funcionan en 2026: la exportación CSV de la app y sus límites, los endpoints de la API que lo devuelven todo, los exportadores de terceros y la alternativa sin exportar que hace desaparecer el problema.

Por Qué Necesitas tu Historial Completo de Hyperliquid

Tu historial de cuenta en Hyperliquid no es solo un registro de trades. Para impuestos, para analizar tu rendimiento y para ser honesto contigo mismo, necesitas cuatro flujos de datos separados:

• Fills: cada orden ejecutada con precio, tamaño, lado, timestamp y la comisión pagada.
• Pagos de funding: los pagos periódicos entre longs y shorts — ingresos imponibles en la mayoría de jurisdicciones.
• Depósitos y retiradas: el dinero que entró y salió del exchange.
• PnL cerrado: lo que cada posición ganó de verdad después de comisiones, no lo que mostraba el gráfico.

Si te falta cualquiera de estos flujos, tu declaración está mal. Solo el funding puede mover el PnL anual en miles de dólares para un trader activo, y las autoridades fiscales de EE. UU., Reino Unido, España, Alemania y Australia tratan el funding de perps como ingreso declarable. La guía completa de impuestos de Hyperliquid explica cómo declarar cada flujo; esta guía cubre cómo sacar los datos en primer lugar.

Método 1: Exportar desde la App de Hyperliquid (Rápido, pero Limitado)

La app oficial en app.hyperliquid.xyz incluye botones de exportación CSV en la sección Historial de tu portfolio. Abre Portfolio → History y encontrarás opciones de exportación para tus trades y para tu historial de funding.

Funciona, y es genuinamente útil para una consulta rápida. Pero la limitación es estructural: la app solo exporta los registros cargados en ese momento en la interfaz. Tienes que hacer scroll hacia atrás para cargar más historial, y para traders de alta frecuencia con miles de fills eso es inviable. La interfaz oficial no tiene un botón de "descargar todo desde el primer día".

Conclusión: la exportación CSV integrada sirve para actividad reciente, pero no es una solución de historial completo.

Método 2: Sácalo Todo con la API Pública

Hyperliquid expone todos los datos de cuenta a través de un endpoint público sin autenticación: POST https://api.hyperliquid.xyz/info. Solo necesitas la dirección de la wallet — sin API key, sin firma. Las tres llamadas que importan:

• {"type":"userFills","user":"0x…"} — los fills más recientes, hasta 2.000 registros.
• {"type":"userFillsByTime","user":"0x…","startTime":…,"endTime":…} — fills dentro de una ventana temporal, para paginar años de historial en bloques de 2.000.
• {"type":"userFunding","user":"0x…"} — pagos de funding (hasta 500 por llamada, se pagina igual).
• {"type":"userNonFundingLedgerUpdates","user":"0x…"} — depósitos, retiradas y transferencias internas.

Un bucle mínimo en Python que recorre todos tus fills se ve así:

import requests, time

addr = "0xTU_WALLET"
end = int(time.time() * 1000)
start = 0
while end > start:
    r = requests.post("https://api.hyperliquid.xyz/info", json={
        "type": "userFillsByTime", "user": addr,
        "startTime": start, "endTime": end
    }).json()
    if not r: break
    for fill in r: print(fill["time"], fill["coin"], fill["side"], fill["px"], fill["sz"], fill["fee"], fill.get("closedPnl"))
    end = min(f["time"] for f in r) - 1
    time.sleep(0.2)

Cada registro de fill incluye los campos que necesitan las herramientas fiscales: timestamp, moneda, lado, precio, tamaño, comisión y el PnL cerrado de la posición. El recorrido completo para desarrolladores — streams WebSocket, límites de rate y gestión de errores — está en nuestra guía de la API de Hyperliquid en Python.

Conclusión: la API lo devuelve todo, pero tú construyes y mantienes el exportador. Si solo quieres la respuesta, sigue leyendo.

Método 3: Exportadores de Terceros

Como la vía API es engorrosa, han aparecido herramientas que automatizan la paginación. La más conocida es trade-export.hypedexer.com, una herramienta enlazada desde la documentación oficial de Hyperliquid que conecta tu wallet y vuelca tu historial completo en CSV o JSON sin límite de registros. Es de terceros y se mantiene de forma independiente, así que úsala bajo tu responsabilidad — pero funciona para exportaciones completas puntuales.

Otras plataformas fiscales (CoinTracking, Cryptact, TradingAtlas) también aceptan directamente los CSV de Hyperliquid, lo que cubre la mitad fiscal del problema una vez tienes el archivo.

Comparativa de Métodos de Exportación

Método	Qué obtienes	Cobertura del historial	Esfuerzo	Precio	Ideal para
Exportación CSV de la app	CSV de trades y funding	Solo lo cargado en la interfaz (reciente)	Bajo	Gratis	Consulta rápida de lo reciente
API pública (manual)	Todos los fills, funding y transferencias	Completa, paginada (2.000/llamada)	Alto — requiere código	Gratis	Desarrolladores y automatización
Exportador de terceros	Volcado completo CSV / JSON	Historial completo	Medio	Gratis (terceros)	Exportación completa puntual
Hyperfolio	PnL, comisiones y funding desglosados, multi-venue	Historial completo, cualquier wallet, sin exportar	Cero	Gratis, sin registro	Traders que quieren respuestas, no archivos

El patrón es claro: cuanto más completo es el dato, más trabajo cuesta — excepto la última fila. Hyperfolio lee esos mismos datos públicos y los convierte en un desglose de PnL legible: PnL realizado y no realizado, comisiones pagadas, funding recibido o pagado, por wallet y por venue, con señales de smart money incluidas.

Qué Debe Incluir una Exportación Completa

Antes de entregar cualquier archivo a una herramienta fiscal o a un gestor, compruébalo contra esta lista:

• Todos los fills, no solo la ventana más reciente — incluido el PnL cerrado por posición.
• Todos los pagos de funding, con timestamp e importes. Son eventos de ingreso.
• Depósitos y retiradas — necesarios para conciliar el cost basis y demostrar de dónde salió el dinero.
• Comisiones — las de maker y taker reducen tu ganancia imponible y a menudo son deducibles.
• Liquidaciones — una liquidación es una disposición, es decir, un evento imponible, no solo una pérdida.
• Eventos de airdrop — el airdrop genesis de HYPE (noviembre de 2024) tributa como ingreso en muchos países por su valor de mercado.

Errores Comunes al Exportar Datos de Hyperliquid

Estos son los fallos que vemos con más frecuencia, y son exactamente los que descuadran las declaraciones y el análisis de PnL:

• Exportar solo los fills. El funding es un flujo separado; si lo omites, tu cost basis es incorrecto.
• Confiar en la exportación de la interfaz para el historial completo. Solo refleja los registros cargados.
• Ignorar el límite de 2.000 registros de la API. Una sola llamada a userFills trunca en silencio; hay que paginar con userFillsByTime.
• Olvidar los otros venues. Si operas en AsterDEX u otros venues basados en Hyperliquid, ese PnL vive en el mismo ecosistema pero en paneles distintos.
• Mezclar spot y perps sin etiquetar. La mayoría de herramientas fiscales necesitan saber cuál es cuál.

La Alternativa Sin Exportar: Solo Búscalo

Esta es la pregunta honesta: ¿necesitas realmente un archivo, o necesitas los números? Si el objetivo es conocer tu PnL real — lo que ganaste después de comisiones y funding, por wallet, por venue —, exportar es un medio para un fin que Hyperfolio se salta por completo. Pega cualquier dirección de Hyperliquid, o conecta tu wallet, y el desglose ya está ahí: PnL realizado, comisiones, funding, posiciones y flujo de smart money, todo desde los mismos datos públicos que leen los exportadores.

Nada de pelearse con CSVs, ni bucles de paginación, ni esperar a un servidor de terceros. Funciona en segundos, no cuesta nada y no hay que crear ninguna cuenta — ese es el punto.

FAQ

¿Puedo descargar mi historial completo de trades de Hyperliquid en CSV?

Sí, pero no con un solo clic. La app solo exporta los registros cargados; para el historial completo hay que paginar la API pública (userFillsByTime) o usar un exportador de terceros como trade-export.hypedexer.com.

¿Hyperliquid tiene una API para obtener el historial de trades?

Sí. Haz POST a https://api.hyperliquid.xyz/info con type: "userFills" (recientes, hasta 2.000) o type: "userFillsByTime" (paginación por ventana temporal). El funding y las transferencias tienen sus propios tipos: userFunding y userNonFundingLedgerUpdates.

¿El funding de Hyperliquid tributa?

En la mayoría de jurisdicciones, sí. El funding recibido se trata como ingreso y el funding pagado reduce tus ganancias. Tu declaración necesita el flujo de funding separado de los fills — consulta la guía de impuestos de Hyperliquid para los detalles por país.

¿Hasta cuándo llega el historial de trades de Hyperliquid?

Hyperliquid almacena el historial completo de cada cuenta en cadena. No hay límite temporal en los datos — solo en lo que devuelve una llamada a la API (2.000 fills) y en lo que carga la interfaz.

¿Cuál es la forma más fácil de ver mi PnL de Hyperliquid sin exportar?

Usa un tracker de solo lectura: busca cualquier wallet en Hyperfolio y obtendrás el PnL realizado, las comisiones y el funding desglosados al instante — gratis, sin registro y sin descargar nada.

Deja de Exportar, Empieza a Saber

Tu historial de trades es público. Tu PnL también debería serlo — al menos para ti. Ya sea que exportes CSVs para tu gestor o que te saltes todo el proceso, los datos están a una dirección de distancia. Prueba el tracker gratis ahora: conecta tu wallet o busca cualquier dirección de Hyperliquid y mira tu PnL completo desglosado en segundos, sin registro y sin archivos de exportación que gestionar.