# Overview

LiquidCore uses Hyperliquid precompiles for pricing data, enabling an oracle-validated AMM on HyperEVM.

## What the pools provide

LiquidCore pools offer deep, liquid markets for stablecoin–WHYPE pairs (USDT0/WHYPE, USDC/WHYPE, USDH/WHYPE). For **traders**, they deliver predictable execution and tight spreads via oracle-backed pricing. For **aggregators**, they provide a single integration surface: a REST quote API and the **LiquidCore Router** for execution.

**Executing swaps:** Use the **LiquidCore Router** (`0x625aC1D165c776121A52ff158e76e3544B4a0b8B`). It discovers the correct pool for any supported pair—approve the router for `tokenIn` and call `swap(tokenIn, tokenOut, amountIn, minAmountOut)`. When new pools are added, the router is updated so integrators don't need to track pool addresses. The quote API returns this router as `executionAddress`.

## Pricing and fees

* Use the quote API or `estimateSwap` before execution to get current expected output.
* Always set `minAmountOut` for slippage protection.

## Referral support

Pools and the router support referral-aware swaps via:

`swap(tokenIn, tokenOut, amountIn, minAmountOut, refCode)`

Referral allocation applies only for allowlisted `refCode` values. For full referral integration details, see [Referrals](https://docs.liqd.ag/liquidcore-integration/referrals).

## Pools

### Supported trading pairs

**USDT0/WHYPE Pool Address**: `0xA7478A5ff7cB27A8008D6D90785db10223bc6087`

| Token | Symbol | Address                                      |
| ----- | ------ | -------------------------------------------- |
| USDT0 | USDT0  | `0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb` |
| WHYPE | WHYPE  | `0x5555555555555555555555555555555555555555` |

**USDC/WHYPE Pool Address**: `0xD3994A6CF46cA91536376f89aCDadf92eD289a9F`

| Token | Symbol | Address                                      |
| ----- | ------ | -------------------------------------------- |
| USDC  | USDC   | `0xb88339CB7199b77E23DB6E890353E22632Ba630f` |
| WHYPE | WHYPE  | `0x5555555555555555555555555555555555555555` |

**USDH/WHYPE Pool Address**: `0x305e5B1a81879Aa0538338306Cb9430A547E1eEa`

| Token | Symbol | Address                                      |
| ----- | ------ | -------------------------------------------- |
| USDH  | USDH   | `0x111111a1a0667d36bD57c0A9f569b98057111111` |
| WHYPE | WHYPE  | `0x5555555555555555555555555555555555555555` |

## Documentation

* [Trading](https://docs.liqd.ag/liquidcore-integration/trading) - Swap mechanics
* [Integration Guide](https://docs.liqd.ag/liquidcore-integration/integration-guide) - Developer integration
* [Referrals](https://docs.liqd.ag/liquidcore-integration/referrals) - Referral-enabled swap integration
* [API Endpoints](https://docs.liqd.ag/liquidcore-integration/api-endpoints) - REST API (pools, quote, pool data)
* [API Reference](https://docs.liqd.ag/liquidcore-integration/api-reference) - Contract interface for swaps
