Get pool state

Fetches detailed information about one or more liquidity pools across Uniswap V2, V3, and V4. Returns pool state including token addresses, reserves, liquidity, current tick, sqrtRatioX96, fee tier, tick spacing, and hook addresses (V4).

Provide one of poolParameters or poolReferences (not both):
- poolParameters: Look up pools by token pair. Provide token addresses and optional fee/tickSpacing/hooks to find matching pools.
- poolReferences: Look up specific known pools by their reference identifier (pool address for V3, pool ID for V4, pair address for V2).

Authorization

x-api-keystringrequiredheader

Playground key

You're using a shared playground keyCreate a free account and get your own API keys from the dashboard.

Get your keys

Body

application/json

protocolenumrequired

V2V3V4

The protocol of the pool.

chainIdenumdefault:1

110561301371431963244801868421743268453101434216142220431145914481457777777713018453211155111

The unique ID of the blockchain. For a list of supported chains see the FAQ.

pageSizenumber

currentPagenumber

Response

Pool information response successful.

requestIdstring

A unique ID for the request.

poolsobject[]

Array of pool information objects.

pageSizenumber

currentPagenumber

POST/lp/pool_info

Request

curl --request POST \
  --url 'https://liquidity.api.uniswap.org/lp/pool_info' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "protocol": "<enum>",
  "chainId": 1
}'

Response

200

{  "requestId": "<string>",  "pools": [    {      "poolReferenceIdentifier": "<string>",      "poolProtocol": "<string>",      "tokenAddressA": "<string>",      "tokenAddressB": "<string>",      "tickSpacing": "<number>",      "fee": "<string>",      "hookAddress": "<string>",      "chainId": "<number>",      "tokenAmountA": "<string>",      "tokenAmountB": "<string>",      "tokenDecimalsA": "<number>",      "tokenDecimalsB": "<number>",      "poolLiquidity": "<string>",      "sqrtRatioX96": "<string>",      "currentTick": "<number>",      "tokenAReserves": "<string>",      "tokenBReserves": "<string>"    }  ],  "pageSize": "<number>",  "currentPage": "<number>"}