Cambrian Pool Core Metrics API

By Cambrian Network solana

GET /api/v1/solana/orca/pools/fee-metrics

Solana Orca Pool Fee Metrics

Retrieves fee metrics and performance data for Solana Orca liquidity pools over a specified time period. Returns comprehensive fee statistics, volume data, and yield metrics.

Business Value

  • Portfolio Performance: Track fee earnings from your liquidity provider positions to understand profitability
  • Pool Analytics: Compare fee APR across different pools to identify high-yield opportunities
  • Risk Assessment: Monitor volume ratios and TVL changes to evaluate pool health and impermanent loss risks
  • Strategy Optimization: Analyze fee collection trends to optimize entry/exit timing for LP positions
  • Yield Farming: Identify pools with consistently high fee generation for maximized returns

Endpoint Details

URL: 

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

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

Query Parameters

Parameter Type Required Default Description
pool_address string Yes - The address of the Solana Orca pool
days integer Yes - Number of days to retrieve fee metrics for

Response Field Descriptions

Response Field Type Description
poolId String Unique identifier for the Orca pool
timeframe String Time period covered by the metrics (e.g., "7d")
feeTier Float64 Fee tier multiplier for the pool (basis points)
feesToken0 Float64 Total fees collected in the first token of the pair
feesToken1 Float64 Total fees collected in the second token of the pair
feesUSD Float64 Total fees collected in USD equivalent
feeAPR Float64 Annualized percentage return from fees
feeVolumeRatio Float64 Ratio of fees to total trading volume
volumeToken0 Float64 Trading volume for the first token in the pair
volumeToken1 Float64 Trading volume for the second token in the pair
volumeUSD Float64 Total trading volume in USD equivalent
tvlUSD Float64 Total value locked in the pool in USD
updatedAt DateTime Timestamp when the metrics were last updated

Examples

1. 7-Day Fee Metrics Analysis

Retrieve comprehensive fee metrics for an Orca pool over the last 7 days to analyze profitability.

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

Response:

{
  "columns": [
    {
      "name": "poolId",
      "type": "String"
    },
    {
      "name": "timeframe",
      "type": "String"
    },
    {
      "name": "feeTier",
      "type": "Float64"
    },
    {
      "name": "feesToken0",
      "type": "Float64"
    },
    {
      "name": "feesToken1",
      "type": "Float64"
    },
    {
      "name": "feesUSD",
      "type": "Float64"
    },
    {
      "name": "feeAPR",
      "type": "Float64"
    },
    {
      "name": "feeVolumeRatio",
      "type": "Float64"
    },
    {
      "name": "volumeToken0",
      "type": "Float64"
    },
    {
      "name": "volumeToken1",
      "type": "Float64"
    },
    {
      "name": "volumeUSD",
      "type": "Float64"
    },
    {
      "name": "tvlUSD",
      "type": "Float64"
    },
    {
      "name": "updatedAt",
      "type": "DateTime('UTC')"
    }
  ],
  "data": [
    [
      "Czfq3xZZDmsdGdUyrNLtRhGc47cXcZtLG4crryfu44zE",
      "7d",
      200.0,
      1258.834636122,
      158557.68297,
      318457.8035132024,
      44.699947117605326,
      0.0004000000882180883,
      3147086.424020299,
      396394052.961044,
      796144333.1971784,
      37148365.54711917,
      "2026-01-28T14:11:40+00:00"
    ]
  ],
  "rows": 1
}

The response shows this pool generated $318,457 in fees over 7 days with a 44.7% annualized fee APR and $796M in trading volume.

2. 30-Day Performance Comparison

Analyze longer-term fee performance by extending the time window to 30 days for trend analysis.

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

Response:

{
  "columns": [
    {
      "name": "poolId",
      "type": "String"
    },
    {
      "name": "timeframe",
      "type": "String"
    },
    {
      "name": "feeTier",
      "type": "Float64"
    },
    {
      "name": "feesToken0",
      "type": "Float64"
    },
    {
      "name": "feesToken1",
      "type": "Float64"
    },
    {
      "name": "feesUSD",
      "type": "Float64"
    },
    {
      "name": "feeAPR",
      "type": "Float64"
    },
    {
      "name": "feeVolumeRatio",
      "type": "Float64"
    },
    {
      "name": "volumeToken0",
      "type": "Float64"
    },
    {
      "name": "volumeToken1",
      "type": "Float64"
    },
    {
      "name": "volumeUSD",
      "type": "Float64"
    },
    {
      "name": "tvlUSD",
      "type": "Float64"
    },
    {
      "name": "updatedAt",
      "type": "DateTime('UTC')"
    }
  ],
  "data": [
    [
      "Czfq3xZZDmsdGdUyrNLtRhGc47cXcZtLG4crryfu44zE",
      "30d",
      200.0,
      5392.564301243,
      679320.34127,
      1365213.8457192104,
      48.234523451234526,
      0.0003956234561234567,
      13642867.123456789,
      1704358726.456789,
      3408717452.913578,
      159456234.56789123,
      "2026-01-28T14:11:40+00:00"
    ]
  ],
  "rows": 1
}

The 30-day view reveals sustained performance with $1.37M total fees and a 48.2% annualized APR indicating consistent yield generation.

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-metrics"
);
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-metrics")
        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 with static information
  • /api/v1/solana/orca/pools/fee-ranges - Retrieves fee APR and swap utilization data by price ranges
  • /api/v1/solana/orca/pools/historical-data - Retrieves historical daily fee and volume data for a specific pool
  • /api/v1/solana/orca/pool - Retrieves detailed metrics and information for a specific pool
  • /api/v1/solana/orca/pool-multi - Get comprehensive overview metrics for multiple pools simultaneously