Uniswap V4 Positions

Get Position by NFT ID

Return detailed information about a specific Uniswap V4 position using its NFT token ID.

https://misti.up.railway.app/api/uniswap-v4/position
   ?chainid=1
   &nftid=123456
   &apikey=YourApiKeyToken

Query Parameters:

Parameter	Description
`chainid`	The chain ID of the blockchain (e.g., `1` for Ethereum mainnet). Table chain id
`nftid`	The NFT token ID of the Uniswap V4 position
`apikey`	Your API key

Response:

{
    "chain_id": 1,
    "nft_id": 123456,
    "pool_id": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "hook_address": "0xabcdef1234567890abcdef1234567890abcdef12",
    "owner": "0x123456789abcdef123456789abcdef123456789a",
    "token0": "0x0cec1a9154ff802e7934fc916ed7ca50bde6844e",
    "token1": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "fee_tier": 3000,
    "tick_lower": -54000,
    "tick_upper": -52000,
    "liquidity": "1234567890123456789",
    "amount0": "1000000000000000000",
    "amount0_formatted": "1.000000",
    "amount1": "2345678901234567890",
    "amount1_formatted": "2345.678901",
    "collected_fees_token0": "5000000000000000",
    "collected_fees_token1": "11739130434782608",
    "uncollected_fees_token0": "2500000000000000",
    "uncollected_fees_token1": "5869565217391304",
    "position_value_usd": 4567.89,
    "fees_earned_usd": 25.75,
    "creation_timestamp": "2023-08-15T10:30:45Z",
    "creation_block": 17800000,
    "last_update_timestamp": "2024-01-15T14:30:45Z",
    "last_update_block": 19200000,
    "is_in_range": true
}

Get Positions by Pool ID

Return all positions for a specific Uniswap V4 pool.

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

Query Parameters:

Parameter	Description
`chainid`	The chain ID of the blockchain (e.g., `1` for Ethereum mainnet). Table chain id
`poolid`	The Uniswap V4 pool ID
`limit`	Maximum number of positions to return (default: 100, max: 1000)
`offset`	Number of records to skip for pagination (default: 0)
`apikey`	Your API key

Response:

{
    "chain_id": 1,
    "pool_id": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "hook_address": "0xabcdef1234567890abcdef1234567890abcdef12",
    "total_positions": 2847,
    "active_positions": 1523,
    "positions": [
        {
            "nft_id": 123456,
            "owner": "0x123456789abcdef123456789abcdef123456789a",
            "tick_lower": -54000,
            "tick_upper": -52000,
            "liquidity": "1234567890123456789",
            "amount0": "1000000000000000000",
            "amount0_formatted": "1.000000",
            "amount1": "2345678901234567890",
            "amount1_formatted": "2345.678901",
            "uncollected_fees_token0": "2500000000000000",
            "uncollected_fees_token1": "5869565217391304",
            "position_value_usd": 4567.89,
            "fees_earned_usd": 25.75,
            "creation_timestamp": "2023-08-15T10:30:45Z",
            "last_update_timestamp": "2024-01-15T14:30:45Z",
            "is_in_range": true
        },
        {
            "nft_id": 789012,
            "owner": "0x987654321fedcba987654321fedcba987654321b",
            "tick_lower": -55000,
            "tick_upper": -51000,
            "liquidity": "987654321098765432",
            "amount0": "800000000000000000",
            "amount0_formatted": "0.800000",
            "amount1": "1876543210987654321",
            "amount1_formatted": "1876.543211",
            "uncollected_fees_token0": "1800000000000000",
            "uncollected_fees_token1": "4217391304347826",
            "position_value_usd": 3654.21,
            "fees_earned_usd": 18.90,
            "creation_timestamp": "2023-09-20T16:45:30Z",
            "last_update_timestamp": "2024-01-10T09:15:20Z",
            "is_in_range": false
        }
    ]
}

Pool FAQ