Incorporación a Portfolio Margin

Portfolio Margin (PM) está activo en producción y disponible para todas las cuentas. Calcula el margen de sus opciones y sus perpetuos de Hyperliquid de forma conjunta según el riesgo del portafolio en el peor escenario, por lo que un libro con cobertura requiere mucho menos colateral que con Standard Margin. Esta página explica cómo empezar a usarlo. Para saber cómo se calcula el margen en sí, consulte Portfolio Margin.

En resumen: use una nueva wallet de manager, cree su cuenta de Hypercall, active el modo de cuenta unificada de HyperCore, cambie al modo Portfolio y solo entonces deposite.

Por qué se parte de una wallet nueva

Una cuenta de Standard Margin (SM) con saldo o con un libro abierto no puede cambiarse directamente a Portfolio Margin. Hypercall acepta el cambio al modo Portfolio solo cuando la wallet de manager cumple todas estas condiciones:

Requisito	Qué significa
Exactamente una cuenta de Hypercall	El manager controla un único contrato Account. Si no hay ninguno, o hay más de uno, se rechaza.
Saldo Standard en cero	El saldo en efectivo de Standard Margin de la wallet es cero. Cualquier saldo retirable bloquea el cambio.
Sin posiciones	Sin posiciones abiertas ni órdenes abiertas, ni en la wallet de manager ni en su Account.

Estas reglas existen porque los dos modos son tipos de cuenta distintos, no una misma cuenta con una configuración diferente:

• Su colateral se custodia de forma distinta. Pasar de Standard a Portfolio Margin implica mover sus fondos, no activar un interruptor.
• Las posiciones se marginan con reglas distintas. Una posición abierta tendría que volver a marginarse pasando de un conjunto de reglas al otro.
• Por eso el cambio se hace desde una cuenta vacía. Hacer ambas cosas de forma segura en un solo paso no está soportado, y por eso la cuenta debe estar sin posiciones y vacía primero.

El modo de margen se define por wallet de manager, así que una misma wallet no puede operar en ambos modos. El camino más sencillo es una wallet de manager nueva para PM, lo que permite que su cuenta SM actual siga cotizando mientras usted hace la configuración. También puede vaciar su wallet actual (cerrar todo, cancelar todas las órdenes, retirar todo el efectivo Standard) y cambiarla, pero no podrá mantener ese libro SM operando mientras tanto.

Antes de empezar

• Una nueva wallet de manager (una EOA que usted controle, idealmente en una hardware wallet o con una clave protegida de otra forma).
• HYPE en HyperEVM en esa wallet, para el depósito de creación de la cuenta más el gas.
• Los USDC que planea usar como colateral.

Pasos de configuración

Hágalos en orden. El paso 4 debe ir antes del paso 5.

1. Cree una nueva wallet de manager. No reutilice su manager de SM, una API wallet ni una clave de agente.

2. Cree su cuenta de Hypercall. Desde la wallet de manager, llame a createAccount(salt) en el contrato Factory con el depósito de creación en HYPE. Esto despliega su contrato Account y lo activa en HyperCore. Consulte Onboarding (contratos). Cree una sola cuenta para este manager.

3. Active el modo de cuenta unificada de HyperCore para el Account. Envíe la acción hl_set_abstraction, firmada por la wallet de manager, con user igual a la dirección de su Account y abstraction igual a 2 (cuenta unificada). POST /v1/actions/hl_set_abstraction/typed-data devuelve exactamente los datos tipados que debe firmar, y POST /v1/actions/hl_set_abstraction los envía. Espere hasta que HyperCore reporte el Account como unifiedAccount. Los otros modos de cuenta de Hyperliquid, incluido su propio modo de portfolio margin, no están soportados.

4. Cambie al modo Portfolio. Envíe POST /margin-mode con wallet igual a su dirección de manager y margin_mode igual a portfolio, firmado por la wallet de manager (consulte Autenticación). La respuesta devuelve la dirección de su Account como la wallet de PM. Haga esto antes de depositar: mientras una wallet sigue en modo Standard, un depósito en Hypercall se acredita como efectivo Standard, y ese saldo bloquea el cambio hasta que lo retire de nuevo.

5. Deposite USDC en su Account. Deposite a través de la app, que enruta según el modo de margen, o envíe USDC en HyperCore a la dirección de su Account. Los fondos cuentan para el margen una vez que el siguiente snapshot de HyperCore de Hypercall los refleje.

6. Configure sus claves de firma. Las aprobaciones de su antigua wallet SM no se transfieren.

   • Opciones (REST): apruebe su clave de trading para la nueva wallet de manager con POST /approve-agent. Consulte Autorización de agentes.
   • Perpetuos (directivas on-chain): registre una API wallet en su Account con la acción hc_update_api_wallet firmada por el manager. Una API wallet solo puede estar activa en un Account. Consulte Firma EIP-712.

7. Opere. Siga enviando su dirección de manager como wallet en las solicitudes de opciones; Hypercall las enruta a su cuenta PM. Los tipos de orden, la API de órdenes y la firma son los mismos que en Standard Margin. Para perpetuos de Hyperliquid desde la app, consulte Perpetuos en Hypercall.

En la app, elegir Portfolio en Settings > Margin Mode ejecuta los pasos 2 a 4 por usted: crea la cuenta si no tiene ninguna, activa el modo de cuenta unificada y cambia el modo.

Si omite el modo de cuenta unificada

Hypercall valora una cuenta PM a partir de su equity en HyperCore, que HyperCore solo publica para Accounts en modo de cuenta unificada. Si el Account no está en ese modo, el paso 4 se rechaza con 400 pm_account_not_unified. Complete el paso 3, espere a que HyperCore confirme el modo y vuelva a intentarlo.

Si un Account sale más tarde del modo de cuenta unificada, las lecturas del portafolio devuelven 503 pm_account_equity_pending (o 409 pm_account_not_unified si HyperCore nunca publicó equity para él), y las órdenes fallan con un error como missing HyperCore account equity for PM wallet 0x.... Vuelva a activar el modo de cuenta unificada para solucionarlo. Consulte Errores y motivos de rechazo.

Preguntas frecuentes

¿Puedo mantener operando mi cuenta de Standard Margin? Sí. Incorpórese a PM con una nueva wallet de manager y deje su cuenta SM tal como está.

¿Por qué se rechazó mi cambio de modo de margen? El error indica la regla: la wallet no tiene Account (o tiene más de uno), tiene saldo Standard, tiene posiciones u órdenes abiertas, o el Account todavía no está en modo de cuenta unificada de HyperCore (pm_account_not_unified). Consulte Por qué se parte de una wallet nueva.

Deposité antes de cambiar. ¿Qué hago ahora? El depósito se acreditó como efectivo Standard. Retírelo, luego cambie al modo Portfolio y deposite en su Account.

¿Necesito nuevas claves de API? Necesita nuevas aprobaciones. Las aprobaciones de agentes para opciones están vinculadas a la wallet de manager, así que apruebe su clave de nuevo para la nueva. Una API wallet de perpetuos solo puede estar activa en un Account, así que use una clave nueva o elimínela primero de su Account anterior (paso 6).

¿Dónde aprendo cómo funcionan el margen, la liquidación y el settlement en PM? Consulte Portfolio Margin, Ejemplos prácticos de margen PM, Margin Floor, Liquidación y Liquidación al vencimiento.