Hyperliquid Withdrawals

HyperCore is Hyperliquid's margin and state matching engine. To move funds off it the user signs user signs EIP-712 typed signatures, which is submitted onchain by Across's relayers. Across handles the HyperCore → HyperEVM lift, the bridge, and any destination swap.

Endpoints

One flow, one response shape

Every withdrawal uses the same flow and the same quote shape. What differs per route is (a) the steps in swapTxns[] and (b) the settlement mechanism, reported in steps.bridge.provider:

Supported Origin Tokens

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

End-to-end

GET /swap/gasless
  ?inputToken=0x2100000000000000000000000000000000000000   # USDC-PERPS
  &originChainId=1337                                       # HyperCore
  &outputToken=0x0000000000000000000000000000000000000000   # native ETH
  &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.

Caveats

1. Decimals trap. HC tokens = 8 decimals; standard EVM USDC = 6. Re-check before passing amount.
2. 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.
3. Quote expiry is short (typically 60–120s). After quoteExpiryTimestamp, re-quote; submitting a stale quote returns a witness-binding error.
4. 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.
5. USDC always settles via CCTP (steps.bridge.provider: sponsored-cctp) — it is not a separate flow. Always trust fees.submission.amount from the quote rather than computing the lift fee yourself.
6. across (Intents) routes are liquidity-capped. Oversized amounts return 400 AMOUNT_TOO_HIGH with the max in the message. CCTP (USDC) routes are not capped and scale to large sizes.
7. 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.

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));
}

Good to Know

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