Pool Fee Range Analysis

Retrieves fee APR and swap utilization data categorized by price ranges relative to the current price for a specific Orca Whirlpool. This endpoint analyzes liquidity utilization across different price ranges over a specified time period.

Business Value

• Liquidity Optimization: Understand which price ranges are most actively utilized for better capital allocation
• Risk Assessment: Analyze concentration risk by seeing how fees and activity are distributed across price tiers
• Performance Analysis: Track fee generation efficiency across different price ranges relative to current market price
• Strategic Planning: Use utilization patterns to inform liquidity provision strategies in concentrated liquidity pools
• Market Intelligence: Gain insights into trading patterns and price movement expectations within the pool

Endpoint Details

URL:

https://opabinia.cambrian.network/api/v1/solana/orca/pools/fee-ranges

Method: GET
Authentication: Required via X-API-Key header

Query Parameters

Response Field Descriptions

Examples

1. Analyze 7-Day Fee Range Performance

Retrieve fee range analysis for an Orca Whirlpool over the past 7 days to understand liquidity utilization patterns.

curl -X GET "https://opabinia.cambrian.network/api/v1/solana/orca/pools/fee-ranges?pool_address=Czfq3xZZDmsdGdUyrNLtRhGc47cXcZtLG4crryfu44zE&days=7" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response:

{
  "columns": [
    {
      "name": "rangeLabel",
      "type": "String"
    },
    {
      "name": "priceRangeLower",
      "type": "Float64"
    },
    {
      "name": "priceRangeUpper",
      "type": "Float64"
    },
    {
      "name": "tickRangeLower",
      "type": "Float64"
    },
    {
      "name": "tickRangeUpper",
      "type": "Float64"
    },
    {
      "name": "utilization",
      "type": "Float64"
    },
    {
      "name": "updatedAt",
      "type": "DateTime('UTC')"
    }
  ],
  "data": [
    [
      "+/- 5%",
      120.62234321221,
      133.31943197139,
      -21152.0,
      -20152.0,
      94.01,
      "2026-01-28T14:11:07+00:00"
    ],
    [
      "+/- 10%",
      114.27379883262,
      139.66797635098,
      -21693.0,
      -19686.0,
      100.0,
      "2026-01-28T14:11:07+00:00"
    ],
    [
      "+/- 20%",
      101.57671007344001,
      152.36506511016,
      -22871.0,
      -18816.0,
      100.0,
      "2026-01-28T14:11:07+00:00"
    ]
  ],
  "rows": 3
}

The response shows fee range analysis with the +/- 5% range having 94.01% utilization, while wider ranges (+/- 10% and +/- 20%) show 100% utilization, indicating active trading across broader price ranges.

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://deep42.cambrian.network/api/v1/solana/orca/pools/fee-ranges"
);
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://deep42.cambrian.network/api/v1/solana/orca/pools/fee-ranges")
        print(response.json())

asyncio.run(main())

Payment Flow

1. Send a normal request to the endpoint (no API key needed)
2. Server returns 402 Payment Required with payment details
3. The x402 SDK automatically signs a payment authorization with your wallet
4. The SDK resubmits the request with the signed payment
5. Server verifies payment and returns the API response

The x402 SDK handles steps 2–5 automatically.

Network: Base (chain ID 8453) | Currency: USDC | Price: $0.05 per request

Related Endpoints

• /api/v1/solana/orca/pools - Retrieves a list of all Orca pools registered in the backend database
• /api/v1/solana/orca/pools/fee-metrics - Retrieves core metrics like fees, volume, TVL, and Fee APR for a specific Orca Whirlpool