Skip to content
Documentation
Uniswap V4
Pool

Uniswap V4 Pools

Get Pool Information

Return the data from a specific Uniswap V4 pool.

https://misti.up.railway.app/api/uniswap-v4/pool
   ?chainid=1
   &poolid=0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
   &apikey=YourApiKeyToken
  • Try this endpoint in your browser 🔗.

Query Parameters:
ParameterDescription
chainidThe chain ID of the blockchain (e.g., 1 for Ethereum mainnet). Table chain id
poolidThe string representing the pool ID of the Uniswap V4 pool.
apikeyYour API key.

Response:

The response will be a JSON object containing the Uniswap V4 pool's information.

{
    "chain_id": 1,
    "pool_id": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "hook_address": "0xabcdef1234567890abcdef1234567890abcdef12",
    "token0": "0x0cec1a9154ff802e7934fc916ed7ca50bde6844e",
    "token1": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "fee_tier": 3000,
    "initial_tick": -53229,
    "initial_sqrt_price_x96": 5.53457559459772e+27,
    "swap_count": 23430,
    "liquidity": "1234567890123456789",
    "sqrt_price_x96": "1461446703485210103287273052203988822378723970342",
    "tick": -53229,
    "token0_price": "0.0023456789",
    "token1_price": "426.789012345",
    "total_value_locked_usd": "1234567.89",
    "volume_24h": "987654.32",
    "fees_24h": "2962.96",
    "created_at_timestamp": "2021-05-04T23:02:17+02:00",
    "created_at_block_number": 12370088
}

Get Pool Swap History

Returns recent swaps for a Uniswap V4 pool.

https://misti.up.railway.app/api/uniswap-v4/pool/swaps
   ?chainid=1
   &poolid=0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
   &limit=100
   &offset=0
   &apikey=YourApiKeyToken

Query Parameters:
ParameterDescription
chainidThe chain ID of the blockchain
poolidThe Uniswap V4 pool ID
limitMaximum number of swaps to return (default: 100, max: 1000)
offsetNumber of records to skip for pagination (default: 0)
apikeyYour API key

Response:
{
    "pool_id": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "swaps": [
        {
            "transaction_hash": "0x123...",
            "block_number": 18500000,
            "timestamp": "2023-10-15T14:30:45Z",
            "sender": "0xabc...",
            "recipient": "0xdef...",
            "amount0": "-1000000000000000000",
            "amount1": "2345678901234567890",
            "sqrt_price_x96": "1461446703485210103287273052203988822378723970342",
            "tick": -53229,
            "liquidity": "1234567890123456789"
        }
    ]
}

Get Modify Liquidity History

Returns the modify liquidity history for a Uniswap V4 pool.

https://misti.up.railway.app/api/uniswap-v4/pool/modify-liquidity
   ?chainid=1
   &poolid=0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
   &limit=100
   &offset=0
   &apikey=YourApiKeyToken

Query Parameters:
ParameterDescription
chainidThe chain ID of the blockchain
poolidThe Uniswap V4 pool ID
limitMaximum number of records to return (default: 100, max: 1000)
offsetNumber of records to skip for pagination (default: 0)
apikeyYour API key

Response:
{
    "pool_id": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "modify_liquidity_history": [
        {
            "id": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef-123456",
            "pool_id": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
            "pool_entity_id": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
            "liquidity_delta": "1234567890123456789",
            "salt": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
            "sender_id": "0x123456789abcdef123456789abcdef123456789a",
            "sender": "0x123456789abcdef123456789abcdef123456789a",
            "tick_lower": -54000,
            "tick_upper": -52000,
            "hash": "0xabc123def456789abc123def456789abc123def456789abc123def456789abc123",
            "tx_at_timestamp": "1672531200",
            "tx_at_block_number": "18500000"
        },
        {
            "id": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef-789012",
            "pool_id": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
            "pool_entity_id": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
            "liquidity_delta": "-987654321098765432",
            "salt": "0xfedcba0987654321fedcba0987654321fedcba0987654321fedcba0987654321",
            "sender_id": "0x987654321fedcba987654321fedcba987654321b",
            "sender": "0x987654321fedcba987654321fedcba987654321b",
            "tick_lower": -55000,
            "tick_upper": -51000,
            "hash": "0xdef789abc123456def789abc123456def789abc123456def789abc123456def789",
            "tx_at_timestamp": "1672444800",
            "tx_at_block_number": "18495000"
        }
    ]
}

Get Pool Historical Data

Returns historical data for a Uniswap V4 pool with day or hour tracking periods.

https://misti.up.railway.app/api/uniswap-v4/pool/data
   ?chainid=1
   &poolid=0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
   &period=d
   &limit=30
   &offset=0
   &apikey=YourApiKeyToken

Query Parameters:
ParameterDescription
chainidThe chain ID of the blockchain
poolidThe Uniswap V4 pool ID
periodTracking period: d for daily data, h for hourly data
limitMaximum number of data points to return (default: 30, max: 1000)
offsetNumber of records to skip for pagination (default: 0)
apikeyYour API key

Response:
{
    "pool_id": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "period": "d",
    "data": [
        {
            "id": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef-2023-10-15",
            "date": "2023-10-15T00:00:00Z",
            "pool": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
            "liquidity": "1234567890123456789",
            "sqrtPrice": "1461446703485210103287273052203988822378723970342",
            "tick": -53229,
            "volumeToken0": "1000000000000000000",
            "volumeToken0D": "1.000000",
            "volumeToken1": "2345678901234567890",
            "volumeToken1D": "2345.678901",
            "volumeUSD": 50000.25,
            "volumePercentageChange": 15.5,
            "collectedFeesToken0": "3000000000000000",
            "collectedFeesToken1": "7037036704070370",
            "collectedFeesUSD": 150.75,
            "swapCount": "45",
            "open": 0.000427,
            "high": 0.000435,
            "low": 0.000420,
            "close": 0.000432,
            "chainId": 1
        },
        {
            "id": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef-2023-10-14",
            "date": "2023-10-14T00:00:00Z",
            "pool": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
            "liquidity": "1234567890123456789",
            "sqrtPrice": "1461446703485210103287273052203988822378723970342",
            "tick": -53240,
            "volumeToken0": "850000000000000000",
            "volumeToken0D": "0.850000",
            "volumeToken1": "1987654321098765432",
            "volumeToken1D": "1987.654321",
            "volumeUSD": 43500.10,
            "volumePercentageChange": -8.2,
            "collectedFeesToken0": "2550000000000000",
            "collectedFeesToken1": "5962963188445940",
            "collectedFeesUSD": 130.50,
            "swapCount": "38",
            "open": 0.000430,
            "high": 0.000438,
            "low": 0.000425,
            "close": 0.000427,
            "chainId": 1
        }
    ]
}