Bands

Band endpoints provide pre-computed quotes at various trade sizes (band midpoints) for all pools.

Get All Bands

GET /bands

Returns band information for all pools with quotes at band midpoints.

curl https://mainnet.router.ryze.pro/bands

Response

{
  "pools": [
    {
      "poolAddress": "0x22f902cEfcF8b0bEc6489Cb8ac11FdDa9B2aF125",
      "assets": [
        {
          "assetAddress": "0x4200000000000000000000000000000000000006",
          "decimals": 18,
          "bands": [
            {
              "bandIndex": 0,
              "lowerLimit": "250000000000000000000",
              "upperLimit": "1000000000000000000000",
              "midpointUSD": "625000000000000000000",
              "tokenAToB": {
                "amountIn": "390625000000000000",
                "amountOut": "624375000",
                "priceImpact": "100000000000000",
                "effectiveRate": "1598400000000000000000",
                "hops": [
                  {
                    "poolAddress": "0x22f902cEfcF8b0bEc6489Cb8ac11FdDa9B2aF125",
                    "tokenIn": "0x4200...",
                    "tokenOut": "0x8335..."
                  }
                ]
              },
              "tokenBToA": {
                "amountIn": "625000000",
                "amountOut": "390000000000000000",
                "priceImpact": "100000000000000",
                "effectiveRate": "624000000000",
                "hops": [...]
              }
            }
          ],
          "totalBands": 6
        }
      ],
      "totalAssets": 2
    }
  ],
  "totalPools": 2
}

Band Fields

Field	Type	Description
bandIndex	number	Band index (0-based)
lowerLimit	string	Lower USD bound (WAD)
upperLimit	string	Upper USD bound (WAD)
midpointUSD	string	Band midpoint in USD (WAD)
tokenAToB	object	Quote for selling this asset
tokenBToA	object	Quote for buying this asset

Quote Fields (per direction)

Field	Type	Description
amountIn	string	Input amount (raw units)
amountOut	string	Output amount (raw units)
priceImpact	string	Price impact (WAD)
effectiveRate	string	Effective rate (WAD)
hops	array	Route hops

Caching

Response includes Cache-Control: public, max-age=10.

---

Token Band Prices

GET /bands-prices/:token

Returns band quotes for a specific non-USDC token paired with USDC.

Path Parameters

Parameter	Type	Description
token	string	Non-USDC token address

curl https://mainnet.router.ryze.pro/bands-prices/0x4200000000000000000000000000000000000006

Response

{
  "tokenA": {
    "address": "0x4200000000000000000000000000000000000006",
    "symbol": "WETH",
    "decimals": 18
  },
  "tokenB": {
    "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "symbol": "USDC",
    "decimals": 6
  },
  "bands": [
    {
      "bandIndex": 0,
      "range": {
        "minUSD": "250000000000000000000",
        "maxUSD": "1000000000000000000000"
      },
      "midpointUSD": "625000000000000000000",
      "tokenAToB": {
        "amountIn": "390625000000000000",
        "amountOut": "624375000",
        "priceImpact": "100000000000000",
        "effectiveRate": "1598400000000000000000",
        "hops": [...]
      },
      "tokenBToA": {
        "amountIn": "625000000",
        "amountOut": "390000000000000000",
        "priceImpact": "100000000000000",
        "effectiveRate": "624000000000",
        "hops": [...]
      }
    }
  ],
  "lastUpdated": "2026-04-15T12:00:00Z",
  "priceA": "1600250000000000000000",
  "priceB": "1000000000000000000"
}

Field	Type	Description
tokenA	object	The requested token (address, symbol, decimals)
tokenB	object	USDC (the quote token)
bands	array	Band quotes for each size tier
priceA	string	Oracle price of token A (WAD)
priceB	string	Oracle price of USDC (WAD)
lastUpdated	string	Timestamp of data

Errors

Code	Reason
400	Token address missing or token is USDC
404	No USDC-paired pool found