Hyperliquid Withdrawals

HyperCore is Hyperliquid's margin and matching engine. To move funds off it, the user signs EIP-712 typed signatures that Across submits on-chain. Across handles the HyperCore → HyperEVM lift and delivery to the destination chain.

Endpoints in order of integration

Supported Hyperliquid Origin Tokens

The 0x2… addresses are HyperCore sentinels — they are not HyperEVM ERC-20s. Destinations: any EVM chain Across supports.

End-to-end integration flow

GET /swap/gasless
  ?inputToken=0x2100000000000000000000000000000000000000   # USDC-PERPS
  &originChainId=1337                                       # HyperCore
  &outputToken=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913   # USDC on Base
  &destinationChainId=8453                                  # Base
  &amount=100000000                                         # 1 USDC (8 decimals on HC)
  &depositor=<user EOA>
  &recipient=<destination addr>
  &integratorId=<your id>

const sigs: Record<string, string> = {};
for (const step of quote.swapTxns) {
  if (step.ecosystem === 'hypercore') {
    sigs[step.stepId] = await hlSign(step.typedData);   // HL wallet
  } else if (step.ecosystem === 'evm-gasless') {
    sigs[step.stepId] = await evmSign(step.typedData); // EVM EOA — EIP-712
  }
}

POST /gasless/submit
{
  "swapTx":             <quote.swapTx>,
  "swapTxns":           <quote.swapTxns>,
  "signaturesByStepId": { "hypercore-transfer": "0x…", "gasless-auth": "0x…" }
}

GET /deposit/status?depositId=<id>&originChainId=1337

Gas Fees

HyperCore → HyperEVM mirror moves cost a small HyperEVM gas fee.

• USDC / USDT origin — fee is paid in-kind or auto-deducted in HYPE. Users don't need to think about it.
• HYPE / non-stablecoin origin — users must hold HYPE on HyperCore to cover gas.

This lift cost is reported at fees.submission on every quote (a flat amount in the submission token, independent of size). fees.total / fees.totalMax cover any protocol/relayer spread — 0 for same-asset USDC routes.

Minimal Example: HC USDC-PERPS → Base ETH

const quote = await fetch(`${BASE}/swap/gasless?inputToken=0x2100…&…`).then(r => r.json());

const sigs: Record<string, string> = {};
for (const step of quote.swapTxns) {
  sigs[step.stepId] = step.ecosystem === 'hypercore'
    ? await hlSign(step.typedData)
    : await evmSign(step.typedData);
}

const { depositId } = await fetch(`${BASE}/gasless/submit`, {
  method: 'POST',
  body: JSON.stringify({
    swapTx: quote.swapTx,
    swapTxns: quote.swapTxns,
    signaturesByStepId: sigs,
  }),
}).then(r => r.json());

while (true) {
  const { status } = await fetch(
    `${BASE}/deposit/status?depositId=${depositId}&originChainId=1337`,
  ).then(r => r.json());
  if (['filled', 'expired', 'refunded', 'deposit-failed'].includes(status)) break;
  await new Promise(r => setTimeout(r, 2000));
}

Caveats

1. HL nonces are wallet-unique. If your client races two quotes, sign + submit them in order — HL will reject a later nonce that arrives first as stale.
2. Quote expiry is short (typically 60–120s). After quoteExpiryTimestamp, re-quote; submitting a stale quote returns a witness-binding error.
3. Don't mutate swapTx or swapTxns between quote and submit. The submit endpoint re-validates byte-for-byte; any drift returns a deep-equal error.
4. Trust fees.submission.amount from the quote rather than computing the lift fee yourself.
5. Very large amounts may exceed a route's available liquidity and return 400 AMOUNT_TOO_HIGH (the max is in the message).
6. recipient ≠ depositor is fine — but the depositor EOA must own the HC funds and sign every step.

All validation errors return 400 InvalidParamError with a param field telling you which input to fix. Most "re-quote" errors are TOCTOU freshness checks — retrying the same body will keep failing.

References

• GET /swap/gasless — quote endpoint reference
• POST /gasless/submit — submit endpoint reference
• Working with Hypercore — companion deposits guide
• Tracking Deposits — generic deposit polling for non-gasless flows
• Refunds — refund mechanics on Across