API Reference

The Ryze API is a Fastify server that provides pool data, portfolio tracking, analytics, and configuration.

Base URL

https://mainnet.api.ryze.pro/api

Method	Path	Description
`GET`	`/health`	Service health check
`GET`	`/assets`	Token list with metadata
`GET`	`/pools`	Pool states (paginated)
`GET`	`/pools/list`	All pools with metadata
`GET`	`/pools/:address`	Pool summary stats
`GET`	`/pools/:address/volume`	Volume candles
`GET`	`/pools/:address/fees`	Fee candles
`GET`	`/pools/:address/apr`	Pool APR breakdown
`GET`	`/pools/tokens/:token/volume`	Token volume
`GET`	`/portfolio/pools/:address`	User LP positions
`GET`	`/portfolio/order-history/:address`	User swap history
`GET`	`/portfolio/units/:address`	User unit balances
`GET`	`/portfolio/rewards/:address`	User claimed rewards
`GET`	`/portfolio/division/:address`	User division/tier
`GET`	`/portfolio/divisions`	All division definitions
`GET`	`/portfolio/claimable-epochs/:address`	Unclaimed epoch rewards
`GET`	`/portfolio/trading-savings/:address`	User trading savings
`GET`	`/portfolio/trading-savings/:address/chart`	Monthly savings chart
`GET`	`/portfolio/trading-savings/:address/swaps`	Swap comparison details
`GET`	`/analytics/protocol`	Protocol-wide stats
`GET`	`/analytics/tvl`	Total value locked
`GET`	`/analytics/wallets`	Unique wallet counts
`GET`	`/analytics/trades/top`	Top trades by size
`GET`	`/analytics/rewards`	Epoch reward stats
`GET`	`/analytics/leaderboard`	Trader leaderboard
`GET`	`/analytics/trading-savings`	Protocol-wide savings
`GET`	`/wbr-config`	WBR configuration
`GET`	`/referral/:address`	Get referral code
`POST`	`/referral/register`	Register referral
`GET`	`/referral/:address/referred`	List referred users

Paginated endpoints accept page and limit query parameters and return:

json

{
  "pagination": {
    "page": 1,
    "limit": 15,
    "totalItems": 42,
    "totalPages": 3,
    "hasNext": true,
    "hasPrev": false
  }
}

Responses are cached for 60 seconds. The Cache-Control header is set for CDN caching.

Large numbers (balances, amounts, units) are returned as strings to preserve BigInt precision.
WAD format: 1e18 = 1.0. Used for weights, fees, prices.
Timestamps in responses are ISO 8601. Timestamps in query parameters are Unix seconds.