πŸ“–Overview

LiquidSwap is a DEX aggregator on Hyperliquid. It routes swaps across 28+ DEXs to find optimal execution, with built-in multi-hop routing, revenue sharing, and native HYPE unwrapping.

Quick start

  1. Get a route β€” call GET https://api.liqd.ag/v2/route with tokenIn, tokenOut, and amountIn.

  2. Execute β€” send the returned calldata to the contract address in execution.to.

const route = await fetch(
  'https://api.liqd.ag/v2/route?tokenIn=0x555...&tokenOut=0xB8C...&amountIn=100'
).then(r => r.json());

const tx = await signer.sendTransaction({
  to: route.execution.to,
  data: route.execution.calldata,
});

That's it. No API keys, no registration, no rate limits.

Key features

  • No authentication β€” start calling endpoints immediately

  • No rate limits β€” scale without worrying about quotas or throttling

  • Multi-hop routing β€” set multiHop=true to route through intermediate tokens

  • 28+ DEXs β€” routes across KittenSwap, HyperSwap, LaminarV3, Ramses, and many more (full list in Route Finding)

  • Exact input or output β€” provide amountIn for exact input swaps, or amountOut for exact output

  • Native HYPE unwrapping β€” set unwrapWHYPE=true to receive native HYPE instead of WHYPE

Revenue sharing

LiquidSwap charges no forced fees for API usage. You choose your own fee structure:

  • Custom fees β€” set feeBps (up to 100 = 1%) and feeRecipient on route requests. You keep 97.5% of collected fees; 2.5% goes to protocol.

  • Positive slippage β€” when swaps execute better than quoted, 50% of positive slippage is captured. If feeRecipient is set, half goes to you and half to protocol. Set feeBps=0 with a feeRecipient to earn positive slippage without charging users.

  • Zero-fee option β€” omit feeBps and feeRecipient to operate completely fee-free.

API endpoints

Endpoint
Description

Find optimal swap routes with ready-to-use calldata

Discover pools for a token pair across DEXs

List all tracked tokens with metadata

Get token balances for a wallet

Base URL: https://api.liqd.ag

Contract

MultiHopRouter: 0x744489ee3d540777a66f2cf297479745e0852f7a

Two execution methods are available β€” executeSwaps (with fee collection and positive slippage capture) and executeMultiHopSwap (simpler, for searchers/arbitrageurs). See Execution for full details.

Last updated