Uniswap V3 Positions
Get Position by NFT ID
Return detailed information about a specific Uniswap V3 position using its NFT token ID.
https://misti.up.railway.app/api/uniswap-v3/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 V3 position |
apikey | Your API key |
Response:
{
"chain_id": 1,
"nft_id": 123456,
"pool_address": "0xff2bdf3044c601679dede16f5d4a460b35cebfee",
"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 Address
Return all positions for a specific Uniswap V3 pool.
https://misti.up.railway.app/api/uniswap-v3/positions
?chainid=1
&address=0xff2bdf3044c601679dede16f5d4a460b35cebfee
&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 |
address | The Uniswap V3 pool contract address |
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_address": "0xff2bdf3044c601679dede16f5d4a460b35cebfee",
"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
}
]
}