🔍Find Pools

Returns all pools that contain a specific token pair. Useful for discovering available liquidity and analyzing market depth.

Endpoint: GET https://api.liqd.ag/pools

Authentication: None required — publicly accessible

Rate Limits: No rate limits

Required Parameters

Name	Type	Description	Required	Example
tokenA	address	Address of the first token	Yes	0x5555...
tokenB	address	Address of the second token	Yes	0xB8CE...
chainId	number	Chain to query (999 = HyperEVM, 4663 = Robinhood Chain)	Yes	999

Optional Parameters

Name	Type	Description	Default
excludeDexes	string	Comma-separated routerIndex values to exclude	none
includeDexes	string	Comma-separated routerIndex values to include only	none

Resolve routerIndex values via GET /dexes?chainId=....

Parameter Details:

• tokenA & tokenB: Order doesn't matter — the API finds pools containing both tokens either way

• excludeDexes / includeDexes: Filter by liquidity source. Cannot be used together — use one or the other

Example Requests:

# HyperEVM
GET https://api.liqd.ag/pools?tokenA=0x5555555555555555555555555555555555555555&tokenB=0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb&chainId=999

# Robinhood Chain
GET https://api.liqd.ag/pools?tokenA=0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73&tokenB=0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168&chainId=4663

# Exclude specific sources
GET https://api.liqd.ag/pools?tokenA=0x5555555555555555555555555555555555555555&tokenB=0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb&chainId=999&excludeDexes=1,3

# Include only specific sources
GET https://api.liqd.ag/pools?tokenA=0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73&tokenB=0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168&chainId=4663&includeDexes=1,2

Response Fields

Field	Description
success	Whether the request succeeded
data[]	Array of pools for the pair
data[].poolAddress	Pool contract address
data[].pairedToken	The other token in the pair relative to the query
data[].routerIndex	Liquidity source index (from GET /dexes)
data[].protocol	Liquidity source name
data[].fee	Pool fee
data[].stable	Whether the pool is a stable pool
data[].pair	Human-readable pair symbol
data[].price	Spot price