Cambrian V3 - Pool Info API
GET /api/v1/evm/uniswap/v3/pool
V3 - Pool Info
Overview
Returns a Uniswap V3 pool's current TVL (Total Value Locked), swap volume, fee APR (Annual Percentage Rate), price volatility and mean adjusted volatility (percentage), tick pressure per $1M volume, swap count, and unique user count across six time ranges: 5 minutes, 1 hour, 1 day, 1 week, 1 month, and 1 year.
Business Value
- Real-time Pool Analytics: Access live pool data including current price, liquidity, and tick information for trading decisions
- Historical Performance Metrics: Track swap volume, fee APR, and utilization across multiple timeframes (5min to 1 year)
- Risk Assessment: Monitor pool TVL and tick utilization to evaluate investment opportunities and market conditions
- Trading Optimization: Use current tick and price data to optimize position management and entry/exit strategies
- Portfolio Management: Track pool performance metrics to make informed liquidity provision decisions
Endpoint Details
URL:
https://api.cambrian.org/evm/uniswap/v3/pool
Method: GET
Authentication: Required via X-API-Key header
Query Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| chain_id | integer | No | 8453 | EVM chain ID. Enum: 1, 8453, 42161, 4663, 56 |
| pool_address | string | Yes | - | Pool address with 0x prefix |
Response Field Descriptions
| Response Field | Type | Description |
|---|---|---|
| createdAt | DateTime('UTC') | Timestamp when the pool was created |
| token0Address | String | Contract address of token0 |
| token0Symbol | String | Symbol of token0 |
| token0Decimals | UInt8 | Decimal places of token0 |
| token1Address | String | Contract address of token1 |
| token1Symbol | String | Symbol of token1 |
| token1Decimals | UInt8 | Decimal places of token1 |
| feeTier | UInt32 | Pool fee tier (in hundredths of a basis point) |
| tickSpacing | Int32 | Minimum tick spacing allowed by the pool |
| currentLiquidity | Int256 | Current in-range liquidity of the pool |
| currentSqrtPriceX96 | UInt256 | Current pool price as sqrt(price) * 2^96 |
| currentTick | Int32 | Current tick of the pool |
| currentPoolPrice | Float64 | Current pool price (token1 per token0) |
| poolTvlUsd | Nullable(Float64) | Current pool Total Value Locked in USD |
| swapVolumeUsd | Map(String,Nullable(Float64)) | Swap volume in USD keyed by time range (5 minute, 1 hour, 1 day, 1 week, 1 month, 1 year) |
| feeApr | Map(String,Nullable(Float64)) | Fee APR keyed by time range |
| priceVolatilityPct | Map(String,Nullable(Float64)) | Price volatility percentage keyed by time range |
| priceVolatilityAdjustedPct | Map(String,Nullable(Float64)) | Mean adjusted price volatility percentage keyed by time range |
| tickPressurePer1MUsd | Map(String,Nullable(Float64)) | Tick pressure per $1M volume keyed by time range |
| swapCount | Map(String,Nullable(UInt64)) | Number of swaps keyed by time range |
| uniqueUserCount | Map(String,Nullable(UInt64)) | Number of unique users keyed by time range |
Examples
1. Get Pool Info for a Uniswap V3 Pool
Gets current TVL, volume, fee APR, volatility, tick pressure, swap count, and unique user metrics for a specific pool address on the default chain (Base).
curl -X GET "https://api.cambrian.org/evm/uniswap/v3/pool?pool_address=0xd0b53D9277642d899DF5C87A3966A349A798F224" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json"
Response:
[
{
"columns": [
{
"name": "createdAt",
"type": "DateTime('UTC')"
},
{
"name": "token0Address",
"type": "String"
},
{
"name": "token0Symbol",
"type": "String"
},
{
"name": "token0Decimals",
"type": "UInt8"
},
{
"name": "token1Address",
"type": "String"
},
{
"name": "token1Symbol",
"type": "String"
},
{
"name": "token1Decimals",
"type": "UInt8"
},
{
"name": "feeTier",
"type": "UInt32"
},
{
"name": "tickSpacing",
"type": "Int32"
},
{
"name": "currentLiquidity",
"type": "Int256"
},
{
"name": "currentSqrtPriceX96",
"type": "UInt256"
},
{
"name": "currentTick",
"type": "Int32"
},
{
"name": "currentPoolPrice",
"type": "Float64"
},
{
"name": "poolTvlUsd",
"type": "Nullable(Float64)"
},
{
"name": "swapVolumeUsd",
"type": "Map(String,Nullable(Float64))"
},
{
"name": "feeApr",
"type": "Map(String,Nullable(Float64))"
},
{
"name": "priceVolatilityPct",
"type": "Map(String,Nullable(Float64))"
},
{
"name": "priceVolatilityAdjustedPct",
"type": "Map(String,Nullable(Float64))"
},
{
"name": "tickPressurePer1MUsd",
"type": "Map(String,Nullable(Float64))"
},
{
"name": "swapCount",
"type": "Map(String,Nullable(UInt64))"
},
{
"name": "uniqueUserCount",
"type": "Map(String,Nullable(UInt64))"
}
],
"data": [
[
"2023-09-06T19:56:01+00:00",
"0x4200000000000000000000000000000000000006",
"WETH",
18,
"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
"USDC",
6,
500,
10,
"1076969418605566456",
"3983131221302777020160616",
-197971,
2527.4935782348953,
9679221.767697707,
{
"1 day": 17431251.31434352,
"1 hour": 1586987.9041683765,
"1 month": 547117074.5785177,
"1 week": 91854162.95336562,
"1 year": 12025618562.454132,
"5 minute": 240167.0944801551
},
{
"1 day": 0.328663134414821,
"1 hour": 0.7181369728974452,
"1 month": 0.33914941988687664,
"1 week": 0.24673556346829773,
"1 year": 0.6212079261675258,
"5 minute": 1
},
{
"1 day": 0.012723869787658573,
"1 hour": 0.003537774349828331,
"1 month": 0.06871114503377279,
"1 week": 0.02704513507823556,
"1 year": 0.5312463405558521,
"5 minute": 0.0008854505189848145
},
{
"1 day": 8.832828660626747e-05,
"1 hour": 9.740370488836097e-05,
"1 month": 8.277110638854634e-05,
"1 week": 7.793186806106255e-05,
"1 year": 0.00014959196085917944,
"5 minute": 6.531828438343159e-05
},
{
"1 day": 30.93868536885991,
"1 hour": 33.52262475363869,
"1 month": 34.71944284435581,
"1 week": 28.35473010975349,
"1 year": 32.81166768684503,
"5 minute": 30.811881269652694
},
{
"1 day": 20750,
"1 hour": 1319,
"1 month": 689123,
"1 week": 120428,
"1 year": 12611750,
"5 minute": 176
},
{
"1 day": 180,
"1 hour": 71,
"5 minute": 16
}
]
],
"rows": 1
}
]
Result collections are capped at 10 items. This example response is for the WETH/USDC pool (0.05% fee tier) on Base, with a current TVL of about $9.68M, 1-day swap volume of about $17.4M, and 180 swaps from 180 unique users over the past day. Note that uniqueUserCount only lists time ranges that had recorded activity (5 minute, 1 hour, 1 day here).
x402 Payment Option
This endpoint supports pay-per-use access via the x402 payment protocol (v2): pay $0.05 USDC per request using blockchain micropayments. No API key required.
Quick Start (TypeScript)
npm install @x402/fetch @x402/evm viem
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";
const signer = privateKeyToAccount(process.env.EVM_PRIVATE_KEY as `0x${string}`);
const client = new x402Client();
client.register("eip155:*", new ExactEvmScheme(signer));
const fetchWithPayment = wrapFetchWithPayment(fetch, client);
const response = await fetchWithPayment(
"https://x402.cambrian.org/evm/uniswap/v3/pool"
);
const data = await response.json();
Quick Start (Python)
pip install "x402[httpx]"
import asyncio, os
from eth_account import Account
from x402 import x402Client
from x402.http.clients import x402HttpxClient
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client
async def main():
client = x402Client()
account = Account.from_key(os.getenv("EVM_PRIVATE_KEY"))
register_exact_evm_client(client, EthAccountSigner(account))
async with x402HttpxClient(client) as http:
response = await http.get("https://x402.cambrian.org/evm/uniswap/v3/pool")
print(response.json())
asyncio.run(main())
Payment Flow
- Send a normal request to the endpoint; no API key needed
- Server returns
402 Payment Requiredwith payment details - The x402 SDK signs a payment authorization with your wallet
- The SDK resubmits the request with the signed payment
- Server verifies payment and returns the API response
The x402 SDK handles steps 2 through 5 automatically.
Network: Base (chain ID 8453) | Currency: USDC | Price: $0.05 per request