Cambrian Pool Info API

By Cambrian Network solana

GET /api/v1/solana/meteora-dlmm/pool

Meteora DLMM Pool

Overview

This endpoint returns basic pool information for a Meteora DLMM (Dynamic Liquidity Market Maker) pool. It accepts one or more comma-separated pool addresses and returns pricing, liquidity, volume, and fee metrics for each pool in a single request.

Business Value

  • Pool Analysis: Get comprehensive metrics for any Meteora DLMM pool including liquidity, fees, and volume data
  • Trading Intelligence: Access real-time pricing, volatility metrics, and active bin information for informed trading decisions
  • Liquidity Provider Insights: Monitor pool utilization, APR, and fee generation to optimize liquidity provision strategies
  • Market Research: Track pool creation dates, token pairs, and trading activity for market analysis
  • Risk Assessment: Evaluate price volatility and utilization metrics for risk management

Endpoint Details

URL:

https://api.cambrian.org/solana/meteora-dlmm/pool

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

Query Parameters

Parameter Type Required Default Description
pool_addresses string Yes - Comma-separated pool addresses within the same DEX (up to 11). Example: addr1,addr2,addr3

Response Field Descriptions

Response Field Type Description
chainId UInt16 Numeric chain identifier (900 = Solana)
dexName String Name of the decentralized exchange (e.g. Meteora)
poolAddress FixedString(44) On-chain address of the pool
createdAt DateTime('UTC') Timestamp when the pool was created
token0Address FixedString(44) Mint address of the pool's first token
token0Symbol String Symbol of the first token
token0Decimals UInt8 Decimal precision of the first token
token1Address FixedString(44) Mint address of the pool's second token
token1Symbol String Symbol of the second token
token1Decimals UInt8 Decimal precision of the second token
binStep UInt16 DLMM bin step (basis points between price bins)
feeTier UInt32 Fee tier applied to swaps in the pool
activeBinId Int32 Identifier of the currently active liquidity bin
currentPrice Nullable(Float64) Current price of token0 denominated in token1
lastSwapTime DateTime('UTC') Timestamp of the most recent swap
reserve0Address FixedString(44) Address of the reserve account holding token0
reserve1Address FixedString(44) Address of the reserve account holding token1
token0PriceUSD Float64 Current USD price of token0
token1PriceUSD Float64 Current USD price of token1
tvlToken0 Nullable(Float64) Total value locked denominated in token0
tvlToken1 Nullable(Float64) Total value locked denominated in token1
tvlUSD Nullable(Float64) Total value locked denominated in USD
feesToken0 Nullable(Float64) Accumulated fees denominated in token0
feesToken1 Nullable(Float64) Accumulated fees denominated in token1
fees24h Nullable(Float64) Fees collected in the last 24 hours (USD)
volumeToken0 Nullable(Float64) Trading volume denominated in token0
volumeToken1 Nullable(Float64) Trading volume denominated in token1
volume24h Nullable(Float64) Trading volume in the last 24 hours (USD)
apr24h Float64 Annualized fee APR based on the last 24 hours
swaps24h UInt64 Number of swaps executed in the last 24 hours
binsUsed24h UInt64 Number of distinct liquidity bins used in swaps over the last 24 hours
priceVolatility Nullable(Float64) Measure of price volatility for the pool
utilization24h Nullable(Float64) Percentage utilization of pool liquidity over the last 24 hours

Examples

1. Retrieve pool information for a single Meteora DLMM pool

Fetches current pricing, liquidity, and volume metrics for a specific SOL/USDC Meteora DLMM pool.

curl -X GET "https://api.cambrian.org/solana/meteora-dlmm/pool?pool_addresses=5rCf1DM8LjKTw4YqhnoLcngyZYeNnQqztScTogYHAS6" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response:

[
  {
    "columns": [
      {
        "name": "chainId",
        "type": "UInt16"
      },
      {
        "name": "dexName",
        "type": "String"
      },
      {
        "name": "poolAddress",
        "type": "FixedString(44)"
      },
      {
        "name": "createdAt",
        "type": "DateTime('UTC')"
      },
      {
        "name": "token0Address",
        "type": "FixedString(44)"
      },
      {
        "name": "token0Symbol",
        "type": "String"
      },
      {
        "name": "token0Decimals",
        "type": "UInt8"
      },
      {
        "name": "token1Address",
        "type": "FixedString(44)"
      },
      {
        "name": "token1Symbol",
        "type": "String"
      },
      {
        "name": "token1Decimals",
        "type": "UInt8"
      },
      {
        "name": "binStep",
        "type": "UInt16"
      },
      {
        "name": "feeTier",
        "type": "UInt32"
      },
      {
        "name": "activeBinId",
        "type": "Int32"
      },
      {
        "name": "currentPrice",
        "type": "Nullable(Float64)"
      },
      {
        "name": "lastSwapTime",
        "type": "DateTime('UTC')"
      },
      {
        "name": "reserve0Address",
        "type": "FixedString(44)"
      },
      {
        "name": "reserve1Address",
        "type": "FixedString(44)"
      },
      {
        "name": "token0PriceUSD",
        "type": "Float64"
      },
      {
        "name": "token1PriceUSD",
        "type": "Float64"
      },
      {
        "name": "tvlToken0",
        "type": "Nullable(Float64)"
      },
      {
        "name": "tvlToken1",
        "type": "Nullable(Float64)"
      },
      {
        "name": "tvlUSD",
        "type": "Nullable(Float64)"
      },
      {
        "name": "feesToken0",
        "type": "Nullable(Float64)"
      },
      {
        "name": "feesToken1",
        "type": "Nullable(Float64)"
      },
      {
        "name": "fees24h",
        "type": "Nullable(Float64)"
      },
      {
        "name": "volumeToken0",
        "type": "Nullable(Float64)"
      },
      {
        "name": "volumeToken1",
        "type": "Nullable(Float64)"
      },
      {
        "name": "volume24h",
        "type": "Nullable(Float64)"
      },
      {
        "name": "apr24h",
        "type": "Float64"
      },
      {
        "name": "swaps24h",
        "type": "UInt64"
      },
      {
        "name": "binsUsed24h",
        "type": "UInt64"
      },
      {
        "name": "priceVolatility",
        "type": "Nullable(Float64)"
      },
      {
        "name": "utilization24h",
        "type": "Nullable(Float64)"
      }
    ],
    "data": [
      [
        900,
        "Meteora",
        "5rCf1DM8LjKTw4YqhnoLcngyZYeNnQqztScTogYHAS6",
        "2024-03-30T02:47:42+00:00",
        "So11111111111111111111111111111111111111112",
        "SOL",
        9,
        "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "USDC",
        6,
        4,
        400,
        -5745,
        100.5057315739129,
        "2026-08-25T08:42:45+00:00",
        "EYj9xKw6ZszwpyNibHY7JD5o3QgTVrSdcBp1fMJhrR9o",
        "CoaxzEh8p5YyGLcj36Eo3cUThVJxeKCs7qvLAGDYwBcz",
        100.39827893159513,
        1,
        17369.970428383,
        3465453.105507,
        5209368.241609355,
        304.645926114,
        31093.312021,
        61679.23868636749,
        1276307.765204151,
        124986578.486202,
        128139103.01352717,
        432.1622330459232,
        31785,
        228,
        67.53971555558917,
        100
      ]
    ],
    "rows": 1
  }
]

Result collections are limited to 10 items. This response returns a single row for the SOL/USDC Meteora DLMM pool, showing a bin step of 4, an active bin of -5745, ~$5.2M TVL, ~$1.28M in 24h volume, and a 24h fee APR of ~67.5%.

x402 Payment Option

This endpoint supports pay-per-use access via the x402 payment protocol (v2), paying $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/solana/meteora-dlmm/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/solana/meteora-dlmm/pool")
        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 through 5 automatically.

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