Skip to main content
POST
Submit a signed Hyperliquid spot↔perp transfer (step 2 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
wallet_address
string
required
amount
string
required
time
integer<int64>
required
to_perp
boolean
required
signature
string
required

0x-prefixed 65-byte signature from the MAIN wallet. Hyperliquid forbids agent wallets from class transfers, so a Kairos-held agent key cannot sign this.

Response

The transfer was submitted.

Response for POST /exchanges/hyperliquid/withdraw and POST /exchanges/hyperliquid/transfer.

success
boolean
required
message
string
required

Withdrawal submitted or Transfer submitted. Submission only — not a confirmation of settlement.