Appearance

Fetch Pools ​

Ryze provides several endpoints for pool data: listing pools, fetching state, volume history, fee history, and APR.

List All Pools ​

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

Returns all pools with metadata and token composition.

bash
curl https://mainnet.api.ryze.pro/api/pools/list
json
{
  "pools": [
    {
      "address": "0x7B41aA91947398CD9244AD4e314C253D9B1B5206",
      "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
}

TIP

Weights are in WAD format. 500000000000000000 = 50% weight.

Get Pool State (Paginated) ​

GET https://mainnet.api.ryze.pro/api/pools?page=1&limit=15

Returns full pool state including balances, fees, bands, and SmartShield parameters.

ParameterTypeDefaultDescription
pagestring"1"Page number
limitstring"15"Items per page (max 15)
addressstring--Filter by specific pool address
bash
# Get a specific pool
curl "https://mainnet.api.ryze.pro/api/pools?address=0x7B41aA91947398CD9244AD4e314C253D9B1B5206"

Get Pool Summary Stats ​

GET https://mainnet.api.ryze.pro/api/pools/:poolAddress

Returns aggregate stats for a pool: total swaps, joins, exits, unique wallets, 24h volume, and 24h fees.

bash
curl https://mainnet.api.ryze.pro/api/pools/0x7B41aA91947398CD9244AD4e314C253D9B1B5206
json
{
  "poolAddress": "0x7b41aa91947398cd9244ad4e314c253d9b1b5206",
  "totalSwaps": 1250,
  "totalJoins": 89,
  "totalExits": 34,
  "uniqueWallets": 156,
  "volume24h": [...],
  "fees24h": [...]
}

Volume History ​

GET https://mainnet.api.ryze.pro/api/pools/:poolAddress/volume?granularity=daily
ParameterTypeRequiredDescription
granularitystringYeshourly, daily, or weekly
fromnumberNoStart timestamp (Unix seconds)
tonumberNoEnd timestamp (Unix seconds)
bash
curl "https://mainnet.api.ryze.pro/api/pools/0x7B41.../volume?granularity=daily&from=1712880000"
json
{
  "poolAddress": "0x7b41...",
  "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": [...]
  }
}

Fee History ​

GET https://mainnet.api.ryze.pro/api/pools/:poolAddress/fees?granularity=daily

Same parameters as volume. Returns fee candles broken down by type (swap, taker, WBF, WBR, slippage).

Pool APR ​

GET https://mainnet.api.ryze.pro/api/pools/:poolAddress/apr
json
{
  "poolAddress": "0x7b41...",
  "apr": {
    "poolAddress": "0x7b41...",
    "totalApr": 12.5,
    "aprBreakdown": {
      "swapFeeApr": 8.2,
      "slippageWbfApr": 4.3
    },
    "poolTvlUsd": "2500000000000000000000000",
    "updatedAt": "2026-04-15T00:00:00.000Z"
  }
}

APR values are percentages (e.g., 12.5 = 12.5%). The breakdown shows:

  • swapFeeApr: From swap fees (100% goes to LPs)
  • slippageWbfApr: From slippage fees (50% to LPs) + WBF (25% to LPs)

Token Volume ​

GET https://mainnet.api.ryze.pro/api/pools/tokens/:tokenAddress/volume?granularity=daily

Get volume for a specific token across all pools.