Cambrian List Pools API
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
- Send a normal request to the endpoint (no API key needed)
- Server returns
402 Payment Requiredwith payment details - The x402 SDK automatically 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–5 automatically.
Network: Base (chain ID 8453) | Currency: USDC | Price: $0.05 per request