# Overview

LiquidSwap is a DEX aggregator on Hyperliquid. It routes swaps across 19 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`.

```javascript
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
* **19 DEXs** — routes across KittenSwap, HyperSwap, Hybra, Ramses, and many more (full list in [Route Finding](/liquidswap-integration/route-finding.md#available-dexs))
* **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                                         |
| ------------------------------------------------------------------- | --------------------------------------------------- |
| [`GET /v2/route`](/liquidswap-integration/route-finding.md)         | Find optimal swap routes with ready-to-use calldata |
| [`GET /pools`](/liquidswap-integration/find-pools.md)               | Discover pools for a token pair across DEXs         |
| [`GET /tokens`](/liquidswap-integration/token-list.md)              | List all tracked tokens with metadata               |
| [`GET /tokens/balances`](/liquidswap-integration/token-balances.md) | 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](/liquidswap-integration/execution.md) for full details.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.liqd.ag/liquidswap-integration/overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.