Cambrian List Pools API

By Cambrian Network solana

GET /api/v1/solana/orca/pools

Orca Pools

Retrieves a comprehensive list of all Orca pools registered in the backend database, providing essential static information about each liquidity pool on the Solana Orca DEX. This endpoint returns pool configurations including token pairs, addresses, decimals, and vault information.

Business Value

  • Pool Discovery: Access a complete registry of all available Orca liquidity pools for market analysis and trading strategy development
  • Token Pair Analysis: Identify trading pairs and their configurations to understand market opportunities and liquidity distribution
  • Integration Support: Obtain essential pool metadata needed for DeFi applications, trading bots, and portfolio management tools
  • Market Research: Analyze the Orca ecosystem structure and track pool creation patterns over time
  • Risk Assessment: Evaluate pool characteristics and token configurations for informed investment decisions

Endpoint Details

URL:

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

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

Query Parameters

Parameter Type Required Default Description
dex string Yes - The Decentralized Exchange (DEX) name. Must be 'orca' for this endpoint.

Response Field Descriptions

Response Field Type Description
poolAddress String The unique address of the Orca liquidity pool
createdAt DateTime Timestamp when the pool was created (UTC)
token0Address String Address of the first token in the pair
token0Symbol String Symbol of the first token
token0Decimals UInt8 Number of decimals for the first token
token1Address String Address of the second token in the pair
token1Symbol String Symbol of the second token
token1Decimals UInt8 Number of decimals for the second token
tickSpacing Int32 The spacing between ticks in the pool's pricing structure
tokenVaultA String Address of the vault holding the first token's reserves
tokenVaultB String Address of the vault holding the second token's reserves

Examples

1. List All Orca Pools

Retrieve the complete list of Orca pools with their configuration details.

curl -X GET "https://opabinia.cambrian.network/api/v1/solana/orca/pools?dex=orca" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response:

{
  "columns": [
    {
      "name": "poolAddress",
      "type": "String"
    },
    {
      "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": "tickSpacing",
      "type": "Int32"
    },
    {
      "name": "tokenVaultA",
      "type": "String"
    },
    {
      "name": "tokenVaultB",
      "type": "String"
    }
  ],
  "data": [
    [
      "11Lz3PqPTEiqJoe7GU9gA7T34GbBGHDUjJ6JmKsx4cA",
      "2026-01-23T01:23:04+00:00",
      "2V2T9WvFMjvYrvJHy7x2ckbuDqtiuGpXsaEkQnUfJ8TW",
      "00",
      6,
      "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "USDC",
      6,
      64,
      "5KJoGu8fi4gTUq5AAqhBVRzUHL1xNJwW9u18Y7rGHt1j",
      "41ozj3uHTuFbMq9yhELR4WQb7aQ3EevNAJZGX2gXFdJM"
    ],
    [
      "122FD4qsy8zkKqW9J2cZmjTN9hPjP8aE6D2GowFURr71",
      "2024-04-19T12:30:25+00:00",
      "So11111111111111111111111111111111111111112",
      "SOL",
      9,
      "7XhEZLWYfJmShx3f2gJTTwFvWFmbgVpZHAp2fozqUg8E",
      "FONG",
      9,
      2,
      "2W6e7m3FKUEKVyuWa86GNgVRbjKAqypQSmXxW7HWTQm3",
      "DsFL1aHUWBUedEXcNfV8BzLmi94GYw6VxSkdWTGNZerc"
    ],
    [
      "12BgjwjLMbodFq3gCYW9cMeyRy9z3eL86kcQ7PiPfUyb",
      "2024-03-12T22:24:39+00:00",
      "So11111111111111111111111111111111111111112",
      "SOL",
      9,
      "4fvS25Zyq9di8VgQtH4o8MrNzDnKuma3Z8fTgwXd1VMx",
      "OPPY",
      6,
      128,
      "36q2sHd31tPYuL8Yhm3wYMwX5cEBpHJYbhhZ5i5TLJjT",
      "7tN6zCdNotfmpY2mKDhgMLVibKvbbyUqcLsjvvqbvotw"
    ],
    [
      "12JuGDhdzWD9uvEYYGhjXsg8ZEuFjz5eqFe1F1gZnL63",
      "2026-01-24T13:27:26+00:00",
      "So11111111111111111111111111111111111111112",
      "SOL",
      9,
      "555fKMS96GnwLzgvvfAoUFWnSTC7tAuWiXdxiR9D6vEj",
      "",
      0,
      128,
      "GNKMi6ZmcPLktztgKbEYMwBqNQ53V78pni5dXDLsKwu4",
      "3fjpQdoP1UNXRL8bhCCQkN8tgbcQ3E6JKpMvPb4wc4vD"
    ],
    [
      "12QYyySmuwqU3VfZv7RhvxYmRK6Twj8wfouFbexoqVms",
      "2026-01-14T07:52:42+00:00",
      "3wkYcJVKtKFzorgcAfbikfCynP4a65cxk5xVm1hJgdku",
      "0",
      6,
      "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "USDC",
      6,
      64,
      "uGv1BQ7RSZYdGR3vjG3xhz7SRJZ5mepkSv5Y3udPjXd",
      "57sjLaUrjrM7bkHqoeJWUcWDMizYDNEU5NKW2GpFjjKu"
    ]
  ],
  "rows": 5
  // ... additional rows omitted for brevity
}

The response returns pool metadata for all registered Orca pools, with each row containing the pool address, creation timestamp, token pair information including addresses and symbols, decimal configurations, tick spacing for price calculations, and vault addresses where the tokens are held.

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"
);
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")
        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