Skip to main content
GET
/
pools
Get pools with filtering
curl --request GET \
  --url https://gateway.ramses.xyz/v3/hyperevm/pools
{
  "totalPools": 123,
  "pools": [
    {
      "id": "<string>",
      "symbol": "<string>",
      "type": "<string>",
      "token0": {
        "id": "<string>",
        "address": "<string>",
        "symbol": "<string>",
        "decimals": 123,
        "priceUsd": 123,
        "name": "<string>"
      },
      "token1": {
        "id": "<string>",
        "address": "<string>",
        "symbol": "<string>",
        "decimals": 123,
        "priceUsd": 123,
        "name": "<string>"
      },
      "feeTier": 123,
      "feeProtocol": 123,
      "tokensStaked": "<string>",
      "gaugeAddress": "<string>",
      "gaugeRewardTokens": [
        "<string>"
      ],
      "feeDistributorAddress": "<string>",
      "feeDistributorRewardTokens": [
        "<string>"
      ],
      "reserve0": 123,
      "reserve1": 123,
      "reserve0Usd": 123,
      "reserve1Usd": 123,
      "tvlUsd": 123,
      "lpRewardsUsd": 123,
      "voterRewardsUsd": 123,
      "lpRewards": [
        {
          "token": {
            "id": "<string>",
            "address": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "priceUsd": 123,
            "name": "<string>"
          },
          "rate": "<string>",
          "usdValue": 123,
          "periodFinish": 123
        }
      ],
      "voterRewards": [
        {
          "token": {
            "id": "<string>",
            "address": "<string>",
            "symbol": "<string>",
            "decimals": 123,
            "priceUsd": 123,
            "name": "<string>"
          },
          "amount": "<string>",
          "usdValue": 123
        }
      ],
      "isCl": true,
      "isStable": true,
      "hasDynamicFees": true,
      "hasCorrelatedTokens": true,
      "hasGauge": true,
      "hasActiveGauge": true,
      "totalVeShareByPeriod": "<string>",
      "totalSupply": "<string>",
      "lpPrice": 123,
      "lpApr": 123,
      "feeApr": 123,
      "rewardApr": 123,
      "voteApr": 123,
      "liquidity": "<string>",
      "sqrtPrice": "<string>",
      "tick": 123,
      "tickSpacing": 123,
      "oneTickFeeApr": 123,
      "oneTickEmissionApr": 123,
      "pctActiveTvl": 123,
      "recommendedRanges": [
        {
          "name": "<string>",
          "value": 123,
          "unit": "<string>",
          "delta": 123,
          "liquidityUsd": 123,
          "rewardApr": 123,
          "feeApr": 123,
          "lpApr": 123,
          "default": true
        }
      ],
      "last24hVolume": 123,
      "last24hFees": 123,
      "last7dVolume": 123,
      "last7dFees": 123
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://tech.ramses.xyz/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

limit
number

Maximum number of pools to return (default: 100)

offset
number

Number of pools to skip (default: 0)

isCl
boolean

Filter by concentrated liquidity pools

hasActiveGauge
boolean

Filter by pools with active gauges

orderBy
enum<string>
default:tvlUsd
required

Field to sort by

Available options:
tvlUsd,
lpApr,
voteApr,
lpRewardsUsd,
voterRewardsUsd
orderDirection
enum<string>
default:desc
required

Sort direction

Available options:
desc,
asc

Response

200 - application/json

Paginated pools response

Paginated pools response

totalPools
number
required

Total number of pools matching query

pools
object[]
required