Pools

List All Pools

GET /pools/list

Returns all pools with metadata and token composition.

curl https://mainnet.api.ryze.pro/api/pools/list

Response

{
  "pools": [
    {
      "address": "0x22f902cEfcF8b0bEc6489Cb8ac11FdDa9B2aF125",
      "name": "WETH-USDC",
      "symbol": "RLP-WETH-USDC",
      "tokens": [
        { "address": "0x4200...0006", "weight": "500000000000000000", "decimals": 18 },
        { "address": "0x8335...2913", "weight": "500000000000000000", "decimals": 6 }
      ],
      "totalSupplyLP": "1000000000000000000000",
      "createdAt": "2026-04-12T00:00:00.000Z"
    }
  ],
  "total": 2
}

Field	Type	Description
address	string	Pool contract address
name	string	Pool name (nullable)
symbol	string	LP token symbol (nullable)
tokens	array	Token addresses, weights (WAD), and decimals
totalSupplyLP	string	Total LP supply (18 decimals)
createdAt	string	ISO 8601 creation time (nullable)

---

Get Pool States

GET /pools

Returns paginated pool states with full balance and configuration data.

Parameter	Type	Default	Description
page	string	"1"	Page number
limit	string	"15"	Items per page (max 15)
address	string	--	Filter by pool address

curl "https://mainnet.api.ryze.pro/api/pools?address=0x22f902cEfcF8b0bEc6489Cb8ac11FdDa9B2aF125"

Response

{
  "poolStates": [ ... ],
  "pagination": {
    "page": 1,
    "limit": 15,
    "totalItems": 2,
    "totalPages": 1,
    "hasNext": false,
    "hasPrev": false
  }
}

---

Pool Summary

GET /pools/:poolAddress

Returns aggregate statistics for a pool.

curl https://mainnet.api.ryze.pro/api/pools/0x22f902cEfcF8b0bEc6489Cb8ac11FdDa9B2aF125

Response

{
  "poolAddress": "0x22f902cefcf8b0bec6489cb8ac11fdda9b2af125",
  "totalSwaps": 1250,
  "totalJoins": 89,
  "totalExits": 34,
  "uniqueWallets": 156,
  "volume24h": [...],
  "fees24h": [...]
}

---

Volume Candles

GET /pools/:poolAddress/volume

Returns volume data aggregated by time interval.

Parameter	Type	Required	Description
granularity	string	Yes	hourly, daily, or weekly
from	number	No	Start timestamp (Unix seconds)
to	number	No	End timestamp (Unix seconds)

curl "https://mainnet.api.ryze.pro/api/pools/0x22f902cEfcF8b0bEc6489Cb8ac11FdDa9B2aF125/volume?granularity=daily"

Response

{
  "poolAddress": "0x22f902cefcf8b0bec6489cb8ac11fdda9b2af125",
  "granularity": "daily",
  "candles": [
    {
      "timestamp": "2026-04-12T00:00:00.000Z",
      "tokenIn": "0x8335...2913",
      "tokenOut": "0x4200...0006",
      "volumeIn": "50000000000",
      "volumeOut": "25000000000000000000",
      "volumeUsd": 50000,
      "swapCount": 42
    }
  ],
  "summary": {
    "totalSwaps": 42,
    "byTokenPair": [
      {
        "tokenIn": "0x8335...",
        "tokenOut": "0x4200...",
        "totalVolumeIn": "50000000000",
        "totalVolumeOut": "25000000000000000000",
        "swapCount": 42
      }
    ]
  }
}

---

Fee Candles

GET /pools/:poolAddress/fees

Returns fee data aggregated by time interval. Same query parameters as volume.

curl "https://mainnet.api.ryze.pro/api/pools/0x22f902cEfcF8b0bEc6489Cb8ac11FdDa9B2aF125/fees?granularity=daily"

Response

{
  "poolAddress": "0x22f902cefcf8b0bec6489cb8ac11fdda9b2af125",
  "granularity": "daily",
  "candles": [
    {
      "timestamp": "2026-04-12T00:00:00.000Z",
      "swapFee": { "token": "0x8335...", "amount": "150000" },
      "takerFee": { "token": "0x8335...", "amount": "50000" },
      "wbfFee": { "token": "0x8335...", "amount": "0" },
      "wbrFee": { "token": "0x8335...", "amount": "10000" },
      "slippageFee": { "token": "0x8335...", "amount": "25000" },
      "swapCount": 42
    }
  ],
  "summary": {
    "totalSwaps": 42,
    "byToken": [
      {
        "token": "0x8335...",
        "swapFee": "150000",
        "takerFee": "50000",
        "wbfFee": "0",
        "wbrFee": "10000",
        "slippageFee": "25000",
        "totalFees": "215000"
      }
    ]
  }
}

---

Pool APR

GET /pools/:poolAddress/apr

Returns the pool's annualized percentage rate breakdown.

curl https://mainnet.api.ryze.pro/api/pools/0x22f902cEfcF8b0bEc6489Cb8ac11FdDa9B2aF125/apr

Response

{
  "poolAddress": "0x22f902cefcf8b0bec6489cb8ac11fdda9b2af125",
  "apr": {
    "poolAddress": "0x22f902cefcf8b0bec6489cb8ac11fdda9b2af125",
    "totalApr": 12.5,
    "aprBreakdown": {
      "swapFeeApr": 8.2,
      "slippageWbfApr": 4.3
    },
    "poolTvlUsd": "2500000000000000000000000",
    "updatedAt": "2026-04-15T00:00:00.000Z"
  }
}

Field	Type	Description
totalApr	number	Total APR as percentage (12.5 = 12.5%)
swapFeeApr	number	APR from swap fees (100% to LPs)
slippageWbfApr	number	APR from slippage (50% to LPs) + WBF (25% to LPs)
poolTvlUsd	string	Pool TVL in USD (WAD)

---

Token Volume

GET /pools/tokens/:tokenAddress/volume

Returns volume for a specific token across all pools.

Parameter	Type	Required	Description
granularity	string	Yes	hourly, daily, or weekly
from	number	No	Start timestamp (Unix seconds)
to	number	No	End timestamp (Unix seconds)

curl "https://mainnet.api.ryze.pro/api/pools/tokens/0x4200...0006/volume?granularity=daily"

Response

{
  "tokenAddress": "0x4200...0006",
  "granularity": "daily",
  "candles": [
    {
      "timestamp": "2026-04-12T00:00:00.000Z",
      "volumeIn": "25000000000000000000",
      "volumeOut": "12500000000000000000",
      "swapCount": 42
    }
  ],
  "summary": {
    "totalVolumeIn": "25000000000000000000",
    "totalVolumeOut": "12500000000000000000",
    "totalSwaps": 42
  }
}