Search Pools by Symbol Pair

Description

Discover all known liquidity pools across all supported chains and DEX protocols for a specific token pair, such as SOL/USDC. Supports optional filtering by 24h volume or TVL in USD.

URL

GET https://pricing.aleno.ai/v1/pools/search?symbol={base}/{quote}

Headers

x-api-key: your-api-key

Query Parameters

Name	Type	Required	Description
symbol	string	Yes	Token pair in the format BASE/QUOTE (e.g., SOL/USDC). Case-insensitive.
minVolumeUsd	number	No	Filters out pools with 24h volume below this USD threshold. Default: 0.
minUsdTvl	number	No	Filters out pools with TVL below this USD threshold. Default: 0.

Response

Returns an array of real-time pool state objects, each representing a matching pool across chains and protocols.

Response Fields

• data — object

  • chainId — string Aleno chain identifier (e.g., eth, arb, etc.).

  • address — string Pool contract address.

  • protocol — string Protocol identifier (e.g. uniswap_v2, sushiswap, etc.).

  • usdTvl — number Total USD value locked in the pool.

  • h24UsdVolume — number 24-hour trading volume in USD across all token pairs in the pool.

  • tokens — array of object Per-token liquidity and volume details:

    • symbol — string Token symbol.

    • address — string Token contract address.

    • decimals — number Token decimals.

    • tvl — number Token balance in the pool (raw units, adjusted for decimals).

    • usdTvl — number USD-equivalent value of the token’s liquidity in the pool.

    • h24Volume — number Token trading volume over the last 24 hours (raw units).

    • h24UsdVolume — number 24-hour trading volume in USD for the token.

    • priceUsd — number USD price of the token implied from the pool state.

  • pairs — array of object Token-to-token price ratios within the pool:

    • base — string Symbol of the base token.

    • quote — string Symbol of the quote token.

    • baseToQuotePrice — number Price of 1 unit of base token in quote token units.

    • quoteToBasePrice — number Price of 1 unit of quote token in base token units.

    • h24UsdVolume — number 24-hour USD trading volume for this token pair.

Example Request

GET https://pricing.aleno.ai/v1/pools/search?symbol=SOL/USDC&minUsdTvl=100000

---

Example Response

{
  "data": [
    {
      "chainId": "solana",
      "address": "8sLbNZoA1cfnvMJLPfp98ZLAnFSYCFApfJKMbiXNLwxj",
      "protocol": "raydium-clmm",
      "usdTvl": 2451669.8364395,
      "h24UsdVolume": 10266629.1308575,
      "tokens": [
        {
          "symbol": "SOL",
          "address": "So11111111111111111111111111111111111111112",
          "decimals": 9,
          "tvl": 17166.280547238,
          "usdTvl": 2247534.07644117,
          "h24Volume": 38436.322725496,
          "h24UsdVolume": 5032362.41892493,
          "priceUsd": 130.92726
        },
        {
          "symbol": "USDC",
          "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
          "decimals": 6,
          "tvl": 204186.8067,
          "usdTvl": 204135.759998325,
          "h24Volume": 5235575.60583401,
          "h24UsdVolume": 5234266.71193255,
          "priceUsd": 0.99975
        }
      ],
      "pairs": [
        {
          "base": "SOL",
          "quote": "USDC",
          "baseToQuotePrice": 130.950983643172,
          "quoteToBasePrice": 0.00763644511999157,
          "h24UsdVolume": 10266629.1308575
        }
      ]
    },
    {
      "chainId": "solana",
      "address": "2QdhepnKRTLjjSqPL1PtKNwqrUkoLee5Gqs8bvZhRdMv",
      "protocol": "raydium-clmm",
      "usdTvl": 561792.073410444,
      "h24UsdVolume": 720872.896000079,
      "tokens": [
        {
          "symbol": "SOL",
          "address": "So11111111111111111111111111111111111111112",
          "decimals": 9,
          "tvl": 2241.559080991,
          "usdTvl": 293481.18860227,
          "h24Volume": 2695.08477448001,
          "h24UsdVolume": 352860.064990385,
          "priceUsd": 130.92726
        },
        {
          "symbol": "USDC",
          "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
          "decimals": 6,
          "tvl": 268377.979303,
          "usdTvl": 268310.884808174,
          "h24Volume": 368104.857224,
          "h24UsdVolume": 368012.831009694,
          "priceUsd": 0.99975
        }
      ],
      "pairs": [
        {
          "base": "SOL",
          "quote": "USDC",
          "baseToQuotePrice": 130.889201861653,
          "quoteToBasePrice": 0.00764004964333861,
          "h24UsdVolume": 720872.896000079
        }
      ]
    }
  ]
}