Skip to main content
POST
/
lp
/
pool_info
Fetch Pool Information
curl --request POST \
  --url https://trade-api.gateway.uniswap.org/v1/lp/pool_info \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "protocol": "V4",
  "chainId": 1,
  "poolParameters": {
    "tokenAddressA": "0x0000000000000000000000000000000000000000",
    "tokenAddressB": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
    "fee": 3000,
    "tickSpacing": 60
  }
}
'
{
  "requestId": "<string>",
  "pools": [
    {
      "poolReferenceIdentifier": "<string>",
      "poolProtocol": [
        "V2"
      ],
      "tokenAddressA": "<string>",
      "tokenAddressB": "<string>",
      "tickSpacing": 123,
      "fee": "<string>",
      "hookAddress": "<string>",
      "chainId": 1,
      "tokenAmountA": "<string>",
      "tokenAmountB": "<string>",
      "tokenDecimalsA": 123,
      "tokenDecimalsB": 123,
      "poolLiquidity": "<string>",
      "sqrtRatioX96": "<string>",
      "currentTick": 123,
      "tokenAReserves": "<string>",
      "tokenBReserves": "<string>"
    }
  ],
  "pageSize": 123,
  "currentPage": 123
}
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). This endpoint is useful for:
  • Resolving pool parameters before creating or increasing a position
  • Fetching current pool state (liquidity, tick, sqrtRatio) needed by other LP endpoints
  • Looking up pool details by token pair or by pool reference identifier

​
Query Methods

Provide one of the following (not both):
  • poolParameters — Look up pools by token pair. Provide token addresses and optional fee/tickSpacing/hooks to find pools matching those parameters. Useful when you know the token pair but not the pool address.
  • poolReferences — Look up specific known pools. Provide an array of PoolReferenceByProtocol objects, each containing a protocol, chainId, and referenceIdentifier (pool address for V3, pool ID for V4, pair address for V2).

​
Key Parameters

  • protocol — The Uniswap protocol version (V2, V3, or V4)
  • chainId — The blockchain network (numeric chain ID)
  • pageSize / currentPage — Optional pagination parameters

​
Response

Returns an array of pools, each containing:
  • poolReferenceIdentifier — The pool address (V3), pool ID (V4), or pair address (V2)
  • poolProtocol — The protocol version
  • tokenAddressA / tokenAddressB — The token pair addresses
  • fee — The fee tier
  • tickSpacing — The tick spacing
  • hookAddress — The hook address (V4 only)
  • poolLiquidity — Current pool liquidity
  • sqrtRatioX96 — Current sqrtPriceX96
  • currentTick — Current tick
  • tokenAmountA / tokenAmountB — Token amounts in the pool
  • tokenDecimalsA / tokenDecimalsB — Token decimals
  • tokenAReserves / tokenBReserves — Pool reserves (V2)

​
Example Request — Query by Pool Parameters

curl --location 'https://api.uniswap.org/lp/pool_info' \
--header 'Content-Type: application/json' \
--header 'x-api-key: XXXXX' \
--data '{
    "protocol": "V4",
    "chainId": 1,
    "poolParameters": {
        "tokenAddressA": "0x0000000000000000000000000000000000000000",
        "tokenAddressB": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "fee": 3000,
        "tickSpacing": 60
    }
}'

​
Example Request — Query by Pool Reference

curl --location 'https://api.uniswap.org/lp/pool_info' \
--header 'Content-Type: application/json' \
--header 'x-api-key: XXXXX' \
--data '{
    "protocol": "V3",
    "chainId": 1,
    "poolReferences": [
        {
            "protocol": "V3",
            "chainId": 1,
            "referenceIdentifier": "0x3470447f3cecffac709d3e783a307790b0208d60"
        }
    ]
}'

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
protocol
enum<string>[]
required

The protocols to use for the swap/order. If the protocols field is defined, then you can only set the routingPreference to BEST_PRICE. Note that the value UNISWAPX is deprecated and will be removed in a future release.

The protocol to use for the swap/order.

Available options:
V2,
V3,
V4,
UNISWAPX,
UNISWAPX_V2,
UNISWAPX_V3
​
poolParameters
object
​
poolReferences
object[]

Array of pool reference identifiers to query. Each reference should include the protocol, chainId, and either the pool address (V3), pool id (V4), or pair address (V2).

​
chainId
enum<number>
default:1

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

Available options:
1,
10,
56,
130,
137,
143,
196,
324,
480,
1868,
4217,
8453,
10143,
42161,
42220,
43114,
59144,
81457,
7777777,
1301,
84532,
11155111
​
pageSize
number
​
currentPage
number

Response

Pool information response successful.

​
requestId
string

A unique ID for the request.

​
pools
object[]

Array of pool information objects.

​
pageSize
number
​
currentPage
number