Analytics

The API provides protocol-wide analytics endpoints for tracking volume, fees, TVL, rewards, and leaderboards.

Protocol Stats

GET https://mainnet.api.ryze.pro/api/analytics/protocol

Returns aggregate protocol statistics.

{
  "totalVolume": {
    "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913": "50000000000",
    "0x4200000000000000000000000000000000000006": "31250000000000000000"
  },
  "totalFees": { ... },
  "totalSwaps": 5000,
  "totalJoins": 200,
  "totalExits": 80,
  "uniqueWallets": 500,
  "poolCount": 2,
  "volume24h": { ... },
  "fees24h": { ... },
  "swaps24h": 150,
  "volume24hUsd": 250000,
  "fees24hUsd": 750,
  "totalVolumeUsd": 5000000,
  "totalFeesUsd": 15000,
  "volume7dUsd": 1200000,
  "volume7dByToken": { ... }
}

TVL (Total Value Locked)

GET https://mainnet.api.ryze.pro/api/analytics/tvl

{
  "pools": [
    {
      "poolAddress": "0x7B41...",
      "totalSupplyLP": "1000000000000000000000",
      "assets": [
        {
          "tokenAddress": "0x4200...0006",
          "balance": "156250000000000000000",
          "weight": "500000000000000000",
          "decimals": 18
        },
        {
          "tokenAddress": "0x8335...2913",
          "balance": "250000000000",
          "weight": "500000000000000000",
          "decimals": 6
        }
      ]
    }
  ],
  "totalByToken": {
    "0x4200000000000000000000000000000000000006": "156250000000000000000",
    "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913": "250000000000"
  }
}

Unique Wallets

GET https://mainnet.api.ryze.pro/api/analytics/wallets

{
  "totalUniqueWallets": 500,
  "breakdown": {
    "swappers": 400,
    "liquidityProviders": 150
  }
}

Top Trades

GET https://mainnet.api.ryze.pro/api/analytics/trades/top?period=24h&limit=10

Parameter	Type	Default	Description
period	string	"24h"	24h, 7d, 30d, or all
limit	number	10	Max 100

{
  "trades": [
    {
      "txHash": "0x...",
      "poolAddress": "0x7B41...",
      "sender": "0xTrader...",
      "tokenIn": "0x8335...2913",
      "tokenOut": "0x4200...0006",
      "amountIn": "1000000000",
      "amountOut": "625000000000000000",
      "timestamp": "2026-04-15T11:30:00.000Z",
      "blockNumber": 44700000
    }
  ],
  "period": "24h",
  "limit": 10
}

Rewards Stats

GET https://mainnet.api.ryze.pro/api/analytics/rewards

{
  "currentEpoch": 5,
  "totalRevenueAllTime": "100000000000000000000",
  "totalDistributedAllTime": "80000000000000000000",
  "totalEmissionsAllTime": "50000000000000000000",
  "recentEpochs": [
    {
      "epochNumber": 5,
      "totalEmission": "10000000000000000000",
      "emissionByCategory": {
        "premium": "4000000000000000000",
        "lp": "3000000000000000000",
        "trader": "2000000000000000000",
        "referral": "1000000000000000000"
      },
      "totalRevenue": "20000000000000000000",
      "distributedRevenue": "16000000000000000000"
    }
  ]
}

Leaderboard

GET https://mainnet.api.ryze.pro/api/analytics/leaderboard?period=7d&limit=20&sortBy=volume

Parameter	Type	Default	Description
period	string	"24h"	24h, 7d, 30d, or all
limit	number	20	Max 100
sortBy	string	"volume"	volume or rewards

{
  "leaderboard": [
    {
      "rank": 1,
      "wallet": "0xTopTrader...",
      "volumeUsd": "500000",
      "swapCount": 150,
      "rewardsUsd": "250"
    }
  ],
  "period": "7d",
  "limit": 20,
  "totalParticipants": 500
}

Trading Savings (Protocol-Wide)

GET https://mainnet.api.ryze.pro/api/analytics/trading-savings

Compares Ryze execution vs. other DEXes across all trades.

{
  "netDifferenceUsd": 15000,
  "totalSavedUsd": 18000,
  "totalLostUsd": 3000,
  "totalSwaps": 5000,
  "swapsWithSavings": 4000,
  "swapsWithLosses": 1000,
  "avgSavingsPercentage": 0.12,
  "uniqueTraders": 500
}

A positive netDifferenceUsd means users collectively saved money trading on Ryze vs. alternatives.