Cambrian Token Pool Search API

By Cambrian Network solana

GET /api/v1/solana/token-pool-search

Token Pool Search

Overview

The Token Pool Search endpoint finds all liquidity pools containing a specific Solana token and returns trading statistics for each pool, including 24-hour volume, trade counts, and buy/sell breakdowns. It helps identify the most active trading venues for a given token across Solana DEXs.

Business Value

  • Pool Discovery: Quickly find all liquidity pools where a specific token is tradeable
  • Volume Analysis: Compare 24-hour trading volumes across different DEXes and pool pairs
  • Trading Insights: Access buy/sell ratio data to understand market sentiment for each pool
  • DEX Comparison: Identify which decentralized exchanges have the most active pools for a token
  • Liquidity Mapping: Understand the full trading landscape for any SPL token across the Solana ecosystem

Endpoint Details

URL: 

https://api.cambrian.org/solana/token-pool-search

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

Query Parameters

Parameter Type Required Default Description
token_address string Yes - Token contract address (base58 format) to search pools for
limit integer No 20 Limit the number of results.
offset integer No 0 Offset the results, allows you to skip a number of rows before starting to return rows.

Response Field Descriptions

Response Field Type Description
tokenAddress String Token contract address (base58 format)
tokenSymbol String Symbol of the queried token
tokenName String Full name of the queried token
tokenDecimals UInt8 Number of decimal places for the token
tokenPrice Float64 Current USD price of the token
poolAddress FixedString(44) Address of the liquidity pool
poolDex String DEX where the pool is hosted (e.g., pump_amm)
poolPairToken String Symbol of the paired token in the pool
volume24hUSD Float64 24-hour trading volume in USD for the pool
volume24hToken Float64 24-hour trading volume denominated in the token
trades24hCount UInt64 Total number of trades in the pool over the last 24 hours
buys24hCount UInt64 Number of buy trades in the pool over the last 24 hours
sells24hCount UInt64 Number of sell trades in the pool over the last 24 hours

Examples

1. Find Top Pools for Wrapped SOL

This example searches for pools containing Wrapped SOL and limits the results to the top 10, the most active trading venues for the token.

curl -X GET "https://api.cambrian.org/solana/token-pool-search?token_address=So11111111111111111111111111111111111111112&limit=10" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response:

[
  {
    "columns": [
      {
        "name": "tokenAddress",
        "type": "String"
      },
      {
        "name": "tokenSymbol",
        "type": "String"
      },
      {
        "name": "tokenName",
        "type": "String"
      },
      {
        "name": "tokenDecimals",
        "type": "UInt8"
      },
      {
        "name": "tokenPrice",
        "type": "Float64"
      },
      {
        "name": "poolAddress",
        "type": "FixedString(44)"
      },
      {
        "name": "poolDex",
        "type": "String"
      },
      {
        "name": "poolPairToken",
        "type": "String"
      },
      {
        "name": "volume24hUSD",
        "type": "Float64"
      },
      {
        "name": "volume24hToken",
        "type": "Float64"
      },
      {
        "name": "trades24hCount",
        "type": "UInt64"
      },
      {
        "name": "buys24hCount",
        "type": "UInt64"
      },
      {
        "name": "sells24hCount",
        "type": "UInt64"
      }
    ],
    "data": [
      [
        "So11111111111111111111111111111111111111112",
        "SOL",
        "Wrapped SOL",
        9,
        73.86343724811887,
        "YQwP3x59QT7HqA5TtjCmFhat5mxFBuUADnoXMUg9js8",
        "pump_amm",
        "NVDA",
        141883505.81124693,
        1920889.5645437944,
        297245,
        211300,
        85945
      ],
      [
        "So11111111111111111111111111111111111111112",
        "SOL",
        "Wrapped SOL",
        9,
        73.86343724811887,
        "6L3RTvmp1fZ3HVmQDHziF7WfRc2P1vCqy6biVPHDbffB",
        "pump_amm",
        "INTC",
        140638424.35520402,
        1904033.0316984504,
        243623,
        144463,
        99160
      ],
      [
        "So11111111111111111111111111111111111111112",
        "SOL",
        "Wrapped SOL",
        9,
        73.86343724811887,
        "CqPPZvtJJB7snvg5jURHVa2zYawT5Vd5MgZrBreyt7jM",
        "pump_amm",
        "NVDIA",
        107801096.57037222,
        1459464.9340275275,
        161258,
        91473,
        69785
      ],
      [
        "So11111111111111111111111111111111111111112",
        "SOL",
        "Wrapped SOL",
        9,
        73.86343724811887,
        "4gJbD9my9KErCd6F6hMfQbHgKR4SCJxUWC7sC7EEbULM",
        "pump_amm",
        "Monkey",
        104502931.91113743,
        1414812.7382712464,
        108445,
        54218,
        54227
      ],
      [
        "So11111111111111111111111111111111111111112",
        "SOL",
        "Wrapped SOL",
        9,
        73.86343724811887,
        "D7kjFM8eyernyL9YNkJujJKjM2GeMJuxxDbdVLQpg7iy",
        "pump_amm",
        "NVDA",
        80218524.26880476,
        1086038.333138196,
        165115,
        117456,
        47659
      ],
      [
        "So11111111111111111111111111111111111111112",
        "SOL",
        "Wrapped SOL",
        9,
        73.86343724811887,
        "7HdXDSP8iYoN6nYU3rAMu6pcQaZYP6mDrQrkXx3yRuXQ",
        "pump_amm",
        "Anthropic",
        79366527.61225885,
        1074503.578078207,
        127633,
        76591,
        51042
      ],
      [
        "So11111111111111111111111111111111111111112",
        "SOL",
        "Wrapped SOL",
        9,
        73.86343724811887,
        "Bkm5aYu8HQouqme6X4GrwuRYXpTWXb8mBQzfhzgunnKj",
        "pump_amm",
        "AIW3",
        78102066.091259,
        1057384.6682615366,
        102963,
        53722,
        49241
      ],
      [
        "So11111111111111111111111111111111111111112",
        "SOL",
        "Wrapped SOL",
        9,
        73.86343724811887,
        "EoF1WjKcfwfJ4jFEs8DkuYf5ptwH79djxy93je7yAi86",
        "pump_amm",
        "HOOD",
        77281758.14204863,
        1046278.9307035237,
        121280,
        71133,
        50147
      ],
      [
        "So11111111111111111111111111111111111111112",
        "SOL",
        "Wrapped SOL",
        9,
        73.86343724811887,
        "5gCQurcLXbhf6eV4uGXWjWawoxFysHx3zccQbBvxWDhW",
        "pump_amm",
        "HOOD",
        69079234.27246518,
        935229.077417792,
        180565,
        131313,
        49252
      ],
      [
        "So11111111111111111111111111111111111111112",
        "SOL",
        "Wrapped SOL",
        9,
        73.86343724811887,
        "FtBED1WfuP8V4HUHCefbsMF7cDFErFXbUGJZ4JRGzwGx",
        "pump_amm",
        "CATE",
        63121689.277874194,
        854572.8662184856,
        82399,
        44332,
        38067
      ]
    ],
    "rows": 10
  }
]

Note: Result collections are limited to 10 items.

The response shows the top 10 pools by 24h volume for Wrapped SOL, all currently on the pump_amm DEX. The top pool, paired with NVDA, recorded over $141M in 24h USD volume and nearly 300,000 trades.

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://x402.cambrian.org/solana/token-pool-search"
);
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/token-pool-search")
        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