Skip to content
Documentation
Uniswap V4
Pool

Uniswap V4 Pools

Return on-chain state and aggregated metrics for one or more Uniswap V4 pools, keyed by their 32-byte pool ID. Each pool entry includes both tokens, the hook address, current price/liquidity, and lifetime volume and fee totals.

ℹ️

Supported protocols: Uniswap V4 and PancakeSwap Infinity.

Get Pool Information

Return data for one or more Uniswap V4 pools on a given chain.

curl -X GET \
  "https://api.misti.app/v1/univ4/pool \
    ?chain_id=1 \
    &pool_ids=0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef \
    &pool_ids=0xfedcba0987654321fedcba0987654321fedcba0987654321fedcba0987654321" \
  -H "x-api-key: YOUR_API_KEY"

Query Parameters:
ParameterTypeRequiredDescription
chain_idnumberYesThe EVM chain ID (e.g., 1 for Ethereum mainnet). Table chain id
pool_idsstringYes32-byte Uniswap V4 pool ID (0x + 64 hex chars). Pass multiple pool_ids params for batch queries (max 20)

Headers:
HeaderDescription
x-api-keyYour API key (msk_…)

Response:
[
    {
        "pool_id": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
        "chain_id": 1,
        "fee": 3000,
        "tick_spacing": 60,
        "current_tick": -53229,
        "sqrt_price_x96": "1461446703485210103287273052203988822378723970342",
        "liquidity": "1234567890123456789",
        "price0": 0.0023456789,
        "price1": 426.789012345,
        "amount0": "500000000000000000000",
        "amount0_d": "500.000000",
        "amount1": "1173394506172839500",
        "amount1_d": "1.173394",
        "volume_token0": "1000000000000000000000",
        "volume_token0_d": "1000.000000",
        "volume_token1": "2345678901234567890",
        "volume_token1_d": "2.345678",
        "volume_usd": 5000000.25,
        "collected_fees_token0": "3000000000000000000",
        "collected_fees_token1": "7037036704070370",
        "collected_fees_usd": 15000.75,
        "tvl_usd": 1234567.89,
        "swap_count": "23430",
        "active_position_count": 142,
        "block_number": "18500000",
        "timestamp": "1697376645",
        "created_at_block_number": "12370088",
        "created_at_timestamp": "1620162137",
        "token0": {
            "address": "0x0cec1a9154ff802e7934fc916ed7ca50bde6844e",
            "symbol": "USDC",
            "name": "USD Coin",
            "decimals": 6,
            "price": 1.0
        },
        "token1": {
            "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "symbol": "WETH",
            "name": "Wrapped Ether",
            "decimals": 18,
            "price": 426.78
        },
        "hook": {
            "address": "0xabcdef1234567890abcdef1234567890abcdef12"
        }
    },
    {
        "pool_id": "0xfedcba0987654321fedcba0987654321fedcba0987654321fedcba0987654321",
        "chain_id": 1,
        "fee": 500,
        "tick_spacing": 10,
        "current_tick": 201234,
        "sqrt_price_x96": "1971681173295648879847653920358146",
        "liquidity": "987654321098765432",
        "price0": 2456.123456,
        "price1": 0.000407,
        "amount0": "250000000000",
        "amount0_d": "250000.000000",
        "amount1": "101745000000000000000",
        "amount1_d": "101.745000",
        "volume_token0": "5000000000000",
        "volume_token0_d": "5000000.000000",
        "volume_token1": "2034902000000000000000",
        "volume_token1_d": "2034.902000",
        "volume_usd": 10000000.50,
        "collected_fees_token0": "2500000000",
        "collected_fees_token1": "1017451000000000000",
        "collected_fees_usd": 5000.25,
        "tvl_usd": 500000.00,
        "swap_count": "85420",
        "active_position_count": 67,
        "block_number": "18500000",
        "timestamp": "1697376645",
        "created_at_block_number": "12450000",
        "created_at_timestamp": "1621180000",
        "token0": {
            "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
            "symbol": "USDC",
            "name": "USD Coin",
            "decimals": 6,
            "price": 1.0
        },
        "token1": {
            "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "symbol": "WETH",
            "name": "Wrapped Ether",
            "decimals": 18,
            "price": 2456.12
        },
        "hook": {
            "address": "0x0000000000000000000000000000000000000000"
        }
    }
]

Pool Fields:
FieldTypeDescription
pool_idstring32-byte Uniswap V4 pool ID
chain_idnumberEVM chain ID
feenumberFee tier in hundredths of a bip (e.g. 3000 = 0.3%)
tick_spacingnumberSpacing between usable ticks
current_ticknumberCurrent tick of the pool
sqrt_price_x96stringCurrent sqrt(price) * 2^96
liquiditystringActive in-range liquidity
price0numberPrice of token0 denominated in token1
price1numberPrice of token1 denominated in token0
amount0 / amount1stringPool reserves for each token (raw units)
amount0_d / amount1_dstringPool reserves for each token (decimal-adjusted)
volume_token0stringLifetime volume of token0 (raw units)
volume_token0_dstringLifetime volume of token0 (decimal-adjusted)
volume_token1stringLifetime volume of token1 (raw units)
volume_token1_dstringLifetime volume of token1 (decimal-adjusted)
volume_usdnumberLifetime volume in USD
collected_fees_token0stringLifetime fees collected in token0 (raw units)
collected_fees_token1stringLifetime fees collected in token1 (raw units)
collected_fees_usdnumberLifetime fees collected in USD
tvl_usdnumberTotal value locked in USD
swap_countstringLifetime number of swaps
active_position_countnumberNumber of currently active liquidity positions
block_numberstringBlock number of the latest update
timestampstringUnix timestamp of the latest update
created_at_block_numberstringBlock number at which the pool was initialized
created_at_timestampstringUnix timestamp at which the pool was initialized
token0 / token1objectToken metadata: address, symbol, name, decimals, price (USD)
hookobjectHook contract attached to the pool: address
PositionsPositions