HL Portfolio API

Analiza cuentas de Hyperliquid: posiciones, PnL, ejecuciones, órdenes abiertas, funding. Estado completo de la clearinghouse para cualquier wallet. La capa de cartera que los agentes necesitan para inteligencia de trading en Hyperliquid. Pago por llamada mediante x402 (USDC en Base L2) -- sin clave API, sin registro, sin límites de tasa.

Parte del marketplace klymax402 -- 100 APIs de micropagos x402 para agentes de IA, una sola wallet, USDC en Base.

Inicio rápido -- MCP

Añade a la configuración de tu cliente MCP (Claude Desktop, Cursor, ElizaOS, etc.):

{
  "mcpServers": {
    "hl-portfolio": {
      "url": "https://hl-portfolio.api.klymax402.com/mcp"
    }
  }
}

Related MCP server: polskidegen-hl-tracker

Inicio rápido -- HTTP (x402)

curl -X POST "https://hl-portfolio.api.klymax402.com/api/account" \
  -H "Content-Type: application/json" \
  -d '{"address":"0x0000000000000000000000000000000000dEaD"}'
# -> 402 Payment Required, with an x402 payment challenge in the response body

Cualquier cliente compatible con x402 (@x402/fetch, x402-agent-tools, ATXP) gestiona automáticamente el ciclo 402 -> firmar -> reintentar.

Herramientas

hyperliquid_get_account_state

Úsala cuando necesites obtener el estado completo del portfolio de una cuenta de perpetuals de Hyperliquid. Devuelve el estado completo de la clearinghouse de cualquier dirección de wallet, incluyendo métricas a nivel de cuenta y detalles por posición.

Parámetros

Respuesta de ejemplo:

{ accountValue: "125430.50", totalNtlPos: "89200.00", withdrawable: "36230.50", positions: [{ coin: "BTC", size: "1.5", entryPrice: "67500.00", unrealizedPnl: "2340.00", leverage: 5, liquidationPrice: "54200.00", marginType: "cross" }] }

Cuándo usarla: para analizar la exposición al riesgo de un trader, comprobar la salud del margen o evaluar la asignación del portfolio en Hyperliquid. Esencial para la evaluación de copy-trading y el monitoreo de riesgo.

No para: el historial de operaciones (usa hyperliquid_get_trade_fills), las órdenes abiertas (usa hyperliquid_get_open_orders), los pagos de funding (usa hyperliquid_get_user_funding), el rendimiento de vaults (usa hyperliquid_get_vault_details) ni el seguimiento de ballenas (usa hyperliquid_detect_whale_trades).

hyperliquid_get_trade_fills

Úsala cuando necesites obtener las ejecuciones (fills) de trading recientes de una cuenta de perpetuals de Hyperliquid. Devuelve las operaciones más recientes con todos los detalles de ejecución, incluido el PnL realizado de las posiciones cerradas.

Parámetros

Respuesta de ejemplo:

{ fills: [{ coin: "ETH", side: "buy", size: "10.0", price: "3450.50", fee: "0.69", closedPnl: "0.00", timestamp: 1712000000000 }], count: 20 }

No para: posiciones actuales (usa hyperliquid_get_account_state), órdenes abiertas pendientes (usa hyperliquid_get_open_orders), pagos de funding (usa hyperliquid_get_user_funding).

hyperliquid_get_open_orders

Úsala cuando necesites ver todas las órdenes pendientes o abiertas de una cuenta de perpetuals de Hyperliquid. Devuelve todas las órdenes en reposo del libro con todos sus parámetros.

Parámetros

Respuesta de ejemplo:

{ orders: [{ coin: "BTC", side: "buy", limitPx: "65000.00", sz: "0.5", orderType: "limit", reduceOnly: false, oid: 123456 }], count: 3 }

No para: operaciones ejecutadas (usa hyperliquid_get_trade_fills), posiciones actuales (usa hyperliquid_get_account_state).

hyperliquid_get_user_funding

Úsala cuando necesites obtener el historial de pagos de funding de una cuenta de perpetuals de Hyperliquid. Devuelve todos los pagos de tasa de funding recibidos o pagados, útil para calcular ingresos/egresos de funding y evaluar la rentabilidad de las operativas de carry trade.

Parámetros

Respuesta de ejemplo:

{ funding: [{ coin: "BTC", fundingRate: "0.0001", payment: "-1.35", timestamp: 1712000000000, positionSize: "1.5" }], totalReceived: "45.20", totalPaid: "-12.30", netFunding: "32.90" }

No para: posiciones actuales (usa hyperliquid_get_account_state), oportunidades de arbitraje de funding (usa funding_arb_find_opportunities), historial de ejecución de operaciones (usa hyperliquid_get_trade_fills).

Ejemplos de prompts para agentes

• "Obtén el estado completo del portfolio de una cuenta de perpetuals de Hyperliquid"

• "Obtén las últimas ejecuciones (fills) de una cuenta de perpetuals de Hyperliquid"

• "Consulta todas las órdenes abiertas/pendientes de una cuenta de perpetuals de Hyperliquid"

Pago

• Protocolo: x402 -- pago por llamada nativo de HTTP, sin registro, ni clave de API

• Red: Base L2 (eip155:8453)

• Activo: USDC

• Facilitador: Coinbase CDP (principal), PayAI (respaldo)

• También accesible a través de ATXP (x402 con envoltura OAuth, metadatos de recurso protegido RFC 9728)

Parte de klymax402

100 APIs de micropagos x402 para agentes de IA -- una wallet, USDC en Base, cero registro.

• Catálogo: https://klymax402.com/llms.txt

• Referencia completa de la API: https://klymax402.com/llms-full.txt

• Estadísticas en vivo: https://klymax402.com/stats

Licencia

MIT