Hyperliquid Support - Relay

Documentation Index

Fetch the complete documentation index at: /llms.txt

Use this file to discover all available pages before exploring further.

Relay supports depositing and withdrawing Hyperliquid (Hypercore) perpsUSDC from any supported chain. To try it today, use the Relay App. Relay also provides complete support for HyperEVM, which can be accessed using the standard quote flow with chainId=999. This document details how to integrate Hyperliquid deposits and withdrawals into your application.

API Access

Hyperliquid can be accessed using the standard Relay API flow. To get started, review the execution steps documentation. When you’re ready to execute swaps, refer to the Get Quote API endpoint.

Hyperliquid-Specific API Parameters

Action	Parameter	Input	Description
Deposit to Hyperliquid	toChainId	1337	Hyperliquid Chain ID
	recipient		Hyperliquid Address
Withdraw from Hyperliquid	protocolVersion	v2	Required for withdrawals
	fromChainId	1337	Hyperliquid Chain ID

These parameters are specific to Hyperliquid interactions. All other standard API parameters remain required. Note that protocolVersion: v2 is mandatory for withdrawals.

Supported Currencies

Relay supports the following Hyperliquid currencies:

Perps USDC: Treated with a custom address 0x00000000000000000000000000000000
Spot USDC: Address 0x6d1e7cde53ba9467b783cb7c530ce054
Other Spot currencies: Including USDe, USDH, and other tokens returned by the Hyperliquid RPC

For a complete and up-to-date list of supported currencies, check the Chains API response for Hyperliquid (chainId: 1337).

Currency Addresses

Perps USDC is treated in a custom way with its address being 0x00000000000000000000000000000000
For any other Spot currency the address is the tokenId value returned by the Hyperliquid RPC

curl -X POST https://api.hyperliquid.xyz/info -H 'Content-Type: application/json' -d '{"type": "spotMeta"}' | jq '.tokens[]'

For currencies on HIP-3 DEXs (non-Spot and non-Perps), append the hex-encoded DEX name to the corresponding Spot currency address. For example, USDC on the xyz DEX is represented as 0x6d1e7cde53ba9467b783cb7c530ce05478797a, where 0x6d1e7cde53ba9467b783cb7c530ce054 is the Spot USDC address and 78797a is the hex representation of “xyz”.

Withdrawals from Hyperliquid

Hyperliquid withdrawals use a two-step signature flow. The v2 implementation leverages the unique nonce associated with every Hyperliquid transfer to map deposits to request IDs. This requires two signatures:

Authorize: Sign a nonce-mapping message that associates a specific nonce with a request ID
Deposit: Sign and submit the Hyperliquid transfer transaction using the same nonce

The deposit transaction must use the exact same nonce from the authorization signature. If the nonces don’t match, Relay cannot associate the transfer with the request ID.

Getting Hyperliquid Balances

Use the Hyperliquid info API to query balances. Pass clearinghouseState as the type parameter, then read the withdrawable property, which returns a USD value in human-readable format.

Example Quote Request

Request

Response

curl 'https://api.relay.link/quote/v2' \
  -H 'content-type: application/json' \
  -d '{\n    "user": "0xf3d63166f0ca56c3c1a3508fce03ff0cf3fb691e",\n    "originChainId": 1337,\n    "destinationChainId": 10,\n    "originCurrency": "0x00000000000000000000000000000000",\n    "destinationCurrency": "0x0000000000000000000000000000000000000000",\n    "recipient": "0xf3d63166f0ca56c3c1a3508fce03ff0cf3fb691e",\n    "tradeType": "EXACT_INPUT",\n    "amount": "1000000000",\n    "refundTo": "0xf3d63166f0ca56c3c1a3508fce03ff0cf3fb691e",\n    "protocolVersion": "v2"\n  }'\n```

{\n "steps":[
{
"id":"authorize",
"action":"Sign nonce-mapping for the deposit",
"description":"Sign the message that maps the deposit to the order",
"kind":"signature",
"items":[
{
"status":"incomplete",
"data":{
"sign":{
"signatureKind":"eip712",
"domain":{
"name":"RelayNonceMapping",
"version":"2",
"chainId":1,
"verifyingContract":"0x0000000000000000000000000000000000000000"
},
"types":{
"NonceMapping":[
{
"name":"chainId",
"type":"string"
},
{
"name":"wallet",
"type":"address"
},
{
"name":"depositor",
"type":"address"
},
{
"name":"id",
"type":"bytes32"
},
{
"name":"nonce",
"type":"uint256"
}
]
},
"value":{
"chainId":"hyperliquid",
"wallet":"0xf3d63166f0ca56c3c1a3508fce03ff0cf3fb691e",
"depositor":"0xf3d63166f0ca56c3c1a3508fce03ff0cf3fb691e",
"nonce":1770329064777,
"id":"0x3bfdb54176b619a1f1f59f091a0708d0216a9f74b985b34d092cdcc4f9f4f9f3"
},
"primaryType":"NonceMapping"
},
"post":{
"endpoint":"/authorize",
"method":"POST",
"body":{
"type":"nonce-mapping",
"walletChainId":1337,
"wallet":"0xf3d63166f0ca56c3c1a3508fce03ff0cf3fb691e",
"depositor":"0xf3d63166f0ca56c3c1a3508fce03ff0cf3fb691e",
"nonce":1770329064777,
"id":"0x3bfdb54176b619a1f1f59f091a0708d0216a9f74b985b34d092cdcc4f9f4f9f3",
"signatureChainId":1
}
}
}
}
],
"requestId":"0x02e937b4d022321b56673e12a42064dde45f25b2f7da0db5eb6b4fa5b747f64a"
},
{
"id":"deposit",
"action":"Confirm transaction in your wallet",
"description":"Depositing funds to the relayer to execute the swap for ETH",
"kind":"transaction",
"items":[
{
"status":"incomplete",
"data":{
"action":{
"type":"sendAsset",
"parameters":{
"hyperliquidChain":"Mainnet",
"destination":"0x865eb9baa5492cef598adf7afb1038654fcb7081",
"sourceDex":"",
"destinationDex":"",
"token":"USDC:0x6d1e7cde53ba9467b783cb7c530ce054",
"amount":"10.000000",
"fromSubAccount":"",
"nonce":1770329064777
}
},
"nonce":1770329064777,
"eip712Types":{
"HyperliquidTransaction:SendAsset":[
{
"name":"hyperliquidChain",
"type":"string"
},
{
"name":"destination",
"type":"string"
},
{
"name":"sourceDex",
"type":"string"
},
{
"name":"destinationDex",
"type":"string"
},
{
"name":"token",
"type":"string"
},
{
"name":"amount",
"type":"string"
},
{
"name":"fromSubAccount",
"type":"string"
},
{
"name":"nonce",
"type":"uint64"
}
]
},
"eip712PrimaryType":"HyperliquidTransaction:SendAsset"
},
"check":{
"endpoint":"/intents/status/v3?requestId=0x02e937b4d022321b56673e12a42064dde45f25b2f7da0db5eb6b4fa5b747f64a",
"method":"GET"
}
}
],
"requestId":"0x02e937b4d022321b56673e12a42064dde45f25b2f7da0db5eb6b4fa5b747f64a",
"depositAddress":""
}
],
"fees":{
"gas":{
"currency":{
"chainId":1337,
"address":"0x00000000000000000000000000000000",
"symbol":"USDC",
"name":"USDC (Perps)",
"decimals":8,
"metadata":{
"logoURI":"https://ethereum-optimism.github.io/data/USDC/logo.png",\ "verified":true
}
},
"amount":"0",
"amountFormatted":"0.0",
"amountUsd":"0",
"minimumAmount":"0"
},
"relayer":{
"currency":{
"chainId":1337,
"address":"0x00000000000000000000000000000000",
"symbol":"USDC",
"name":"USDC (Perps)",
"decimals":8,
"metadata":{
"logoURI":"https://ethereum-optimism.github.io/data/USDC/logo.png",\ "verified":true
}
},
"amount":"2924363",
"amountFormatted":"0.02924363",
"amountUsd":"0.029239",
"minimumAmount":"2924363"
},
"relayerGas":{
"currency":{
"chainId":1337,
"address":"0x00000000000000000000000000000000",
"symbol":"USDC",
"name":"USDC (Perps)",
"decimals":8,
"metadata":{
"logoURI":"https://ethereum-optimism.github.io/data/USDC/logo.png",\ "verified":true
}
},
"amount":"21060",
"amountFormatted":"0.0002106",
"amountUsd":"0.000211",
"minimumAmount":"21060"
},
"relayerService":{
"currency":{
"chainId":1337,
"address":"0x00000000000000000000000000000000",
"symbol":"USDC",
"name":"USDC (Perps)",
"decimals":8,
"metadata":{
"logoURI":"https://ethereum-optimism.github.io/data/USDC/logo.png",\ "verified":true
}
},
"amount":"2903303",
"amountFormatted":"0.02903303",
"amountUsd":"0.029028",
"minimumAmount":"2903303"
},
"app":{
"currency":{
"chainId":1337,
"address":"0x00000000000000000000000000000000",
"symbol":"USDC",
"name":"USDC (Perps)",
"decimals":8,
"metadata":{
"logoURI":"https://ethereum-optimism.github.io/data/USDC/logo.png",\ "verified":true
}
},
"amount":"0",
"amountFormatted":"0.0",
"amountUsd":"0",
"minimumAmount":"0"
},
"subsidized":{
"currency":{
"chainId":1337,
"address":"0x00000000000000000000000000000000",
"symbol":"USDC",
"name":"USDC (Perps)",
"decimals":8,
"metadata":{
"logoURI":"https://ethereum-optimism.github.io/data/USDC/logo.png",\ "verified":true
}
},
"amount":"0",
"amountFormatted":"0.0",
"amountUsd":"0",
"minimumAmount":"0"
}
},
"details":{
"operation":"swap",
"sender":"0xf3d63166f0ca56c3c1a3508fce03ff0cf3fb691e",
"recipient":"0xf3d63166f0ca56c3c1a3508fce03ff0cf3fb691e",
"currencyIn":{
"currency":{
"chainId":1337,
"address":"0x00000000000000000000000000000000",
"symbol":"USDC",
"name":"USDC (Perps)",
"decimals":8,
"metadata":{
"logoURI":"https://ethereum-optimism.github.io/data/USDC/logo.png",\ "verified":true
}
},
"amount":"1000000000",
"amountFormatted":"10.0",
"amountUsd":"9.998250",
"minimumAmount":"1000000000"
},
"currencyOut":{
"currency":{
"chainId":10,
"address":"0x0000000000000000000000000000000000000000",
"symbol":"ETH",
"name":"Ether",
"decimals":18,
"metadata":{
"logoURI":"https://assets.relay.link/icons/1/light.png",\ "verified":true
}
},
"amount":"5388446518106479",
"amountFormatted":"0.005388446518106479",
"amountUsd":"9.962860",
"minimumAmount":"5280677587744349"
},
"refundCurrency":{
"currency":{
"chainId":1337,
"address":"0x00000000000000000000000000000000",
"symbol":"USDC",
"name":"USDC (Perps)",
"decimals":8,
"metadata":{
"logoURI":"https://ethereum-optimism.github.io/data/USDC/logo.png",\ "verified":true
}
},
"amount":"1000000000",
"amountFormatted":"10.0",
"amountUsd":"9.998250",
"minimumAmount":"1000000000"
},
"totalImpact":{
"usd":"-0.035390",
"percent":"-0.35"
},
"swapImpact":{
"usd":"-0.006151",
"percent":"-0.06"
},
"expandedPriceImpact":{
"swap":{
"usd":"-0.008146"
},
"execution":{
"usd":"-0.020211"
},
"relay":{
"usd":"-0.007033"
},
"app":{
"usd":"0"
}
},
"rate":"0.0005388446518106479",
"slippageTolerance":{
"origin":{
"usd":"0.000000",
"value":"0",
"percent":"0.00"
},
"destination":{
"usd":"0.199257",
"value":"107768930362130",
"percent":"2.00"
}
},
"timeEstimate":2,
"userBalance":"0",
"isFixedRate":true,
"route":{
"origin":{
"inputCurrency":{
"currency":{
"chainId":1337,
"address":"0x00000000000000000000000000000000",
"symbol":"USDC",
"name":"USDC (Perps)",
"decimals":8,
"metadata":{
"logoURI":"https://ethereum-optimism.github.io/data/USDC/logo.png",\ "verified":true
}
},
"amount":"1000000000",
"amountFormatted":"10.0",
"amountUsd":"9.998250",
"minimumAmount":"1000000000"
},
"outputCurrency":{
"currency":{
"chainId":1337,
"address":"0x00000000000000000000000000000000",
"symbol":"USDC",
"name":"USDC (Perps)",
"decimals":8,
"metadata":{
"logoURI":"https://ethereum-optimism.github.io/data/USDC/logo.png",\ "verified":true
}
},
"amount":"1000000000",
"amountFormatted":"10.0",
"amountUsd":"9.998250",
"minimumAmount":"1000000000"
},
"router":"relay"
},
"destination":{
"inputCurrency":{
"currency":{
"chainId":10,
"address":"0x0000000000000000000000000000000000000000",
"symbol":"ETH",
"name":"Ether",
"decimals":18,
"metadata":{
"logoURI":"https://assets.relay.link/icons/1/light.png",\ "verified":true
}
},
"amount":"5388446518106479",
"amountFormatted":"0.005388446518106479",
"amountUsd":"9.962860",
"minimumAmount":"5280677587744349"
},
"outputCurrency":{
"currency":{
"chainId":10,
"address":"0x0000000000000000000000000000000000000000",
"symbol":"ETH",
"name":"Ether",
"decimals":18,
"metadata":{
"logoURI":"https://assets.relay.link/icons/1/light.png",\ "verified":true
}
},
"amount":"5388446518106479",
"amountFormatted":"0.005388446518106479",
"amountUsd":"9.962860",
"minimumAmount":"5280677587744349"
},
"router":"relay"
}
}
},
"protocol":{
"v2":{
"orderId":"0x3bfdb54176b619a1f1f59f091a0708d0216a9f74b985b34d092cdcc4f9f4f9f3",
"orderData":{
"version":"v1",
"solverChainId":"base",
"solver":"0xf70da97812cb96acdf810712aa562db8dfa3dbef",
"salt":"0xd50b8811d6ae77508a80cf87b5045e00b62fb2507ffa7a2c2bdef8150a919a04",
"inputs":[
{
"payment":{
"chainId":"hyperliquid",
"currency":"0x00000000000000000000000000000000",
"amount":"1000000000",
"weight":"1"
},
"refunds":[
{
"chainId":"hyperliquid",
"recipient":"0xf3d63166f0ca56c3c1a3508fce03ff0cf3fb691e",
"currency":"0x00000000000000000000000000000000",
"minimumAmount":"0",
"deadline":1770933867,
"extraData":"0x"
},
{
"chainId":"optimism",
"recipient":"0xf3d63166f0ca56c3c1a3508fce03ff0cf3fb691e",
"currency":"0x0000000000000000000000000000000000000000",
"minimumAmount":"0",
"deadline":1770933867,
"extraData":"0x000000000000000000000000b92fe925dc43a0ecde6c8b1a2709c170ec4fff4f"
}
]
}
],
"output":{
"chainId":"optimism",
"payments":[
{
"recipient":"0xf3d63166f0ca56c3c1a3508fce03ff0cf3fb691e",
"currency":"0x0000000000000000000000000000000000000000",
"minimumAmount":"5280677587744349",
"expectedAmount":"5388446518106479"
}
],
"calls":[

],
"deadline":1770933867,
"extraData":"0x000000000000000000000000b92fe925dc43a0ecde6c8b1a2709c170ec4fff4f"
},
"fees":[

]
},
"paymentDetails":{
"chainId":"hyperliquid",
"depository":"0x865eb9baa5492cef598adf7afb1038654fcb7081",
"currency":"0x00000000000000000000000000000000",
"amount":"1000000000"
}
}
} }