Hyperliquid

Build the typed data for a Hyperliquid spot↔perp transfer (step 1 of 2)

Builds the EIP-712 usdClassTransfer payload for moving USDC between your own Hyperliquid spot and perp balances. Funds never leave your account — there is no destination and nothing to mis-address. Your MAIN wallet must sign: Hyperliquid forbids agent wallets from class transfers, so a Kairos-held agent key cannot do this for you. This call is pure — same properties as the withdraw prepare: no writes, no reservation, no binding to the submit step. Auth & scope. Requires trade:execute for hyperliquid, wallet ownership, and the mutation gate. Not rate limited.

post/exchanges/hyperliquid/transfer/prepare

Request

Base URL
https://execution.kairos.trade
Auth
API key in header X-Client-Id and API key in header X-Api-Key and API key in header X-Api-Secret

Request body

wallet_addressstring required

amountstring required

USDC amount, same plain-decimal validation as withdraw. No Kairos-side minimum or maximum.

to_perpboolean required

true moves spot → perp; false moves perp → spot. Funds never leave the account.

Response

Typed data to sign, plus the time nonce to echo back.

typed_dataobject required

EIP-712 typed data for Hyperliquid's usdClassTransfer action.

timeinteger required

Millisecond timestamp, doubles as the nonce.