Skip to main content
POST
Build the typed data for a Hyperliquid spot↔perp transfer (step 1 of 2)

Authorizations

X-Client-Id
string
header
required

Credential client id (kairos_ck_...). Must be sent together with X-Api-Key and X-Api-Secret.

X-Api-Key
string
header
required

64-char hex API key.

X-Api-Secret
string
header
required

64-char hex API secret.

Body

application/json

Body for POST /exchanges/hyperliquid/transfer/prepare. Pure — writes nothing.

wallet_address
string
required
amount
string
required

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

to_perp
boolean
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_data
object
required

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

time
integer<int64>
required

Millisecond timestamp, doubles as the nonce.

amount
string
required
to_perp
boolean
required