📖Overview

LiquidSwap is a multichain aggregator. It finds optimal swap routes across liquidity on supported chains, with built-in multi-hop routing, revenue sharing, and native token unwrapping.

Supported chains

Chain

chainId

HyperEVM

999

Robinhood Chain

4663

Pass chainId on route, tokens, token balances, liquidity sources, and pools requests.

Quick start

Get a route — call GET https://api.liqd.ag/v2/route with tokenIn, tokenOut, amountIn, and chainId.
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&chainId=999'
).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
Multichain — same API across HyperEVM and Robinhood Chain via chainId
Multi-hop routing — set multiHop=true to route through intermediate tokens
Exact input or output — provide amountIn for exact input swaps, or amountOut for exact output
Native unwrapping — set unwrapNative=true to receive native HYPE (HyperEVM) or ETH (Robinhood Chain) instead of the wrapped token

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.