Leaderboard summary (header stats + volume-by-network donut)

Returns the leaderboard header stats and the "Volume by network" breakdown for the selected `period`, aggregated over all supported chains. Rankings refresh continuously (typically within minutes). `liquidity.shared` (allocated strategy balances), `liquidity.pullable` (the same balances capped by on-chain wallet balance and allowance) and `makers.total` are point-in-time values and do not change with `period`. While leaderboard data has not been computed yet the endpoint returns the empty state: `{liquidity: {shared: {usd: null}, pullable: {usd: null}}, makers: {total: 0}, performance: {volume: {usd: null, networks: []}, apy: {top: null}}}`.

GEThttps://api.1inch.com/aqua/v1.0/leaderboard/summary
Supported on:
EthereumBaseBNB ChainAvalancheZKsyncGnosisOptimismPolygonLineaSonicUnichainRobinhoodArbitrum

Parameters

period
string (Enum)query
Leaderboard timeframe over which volume and APY are aggregated

Request Body

This request doesn’t have any request body.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
const axios = require('axios');

async function httpCall() {
  const url = 'https://api.1inch.com/aqua/v1.0/leaderboard/summary';

  const config = {
    headers: {
      Authorization: `Bearer ${API_KEY}`,
    },
    params: {},
    paramsSerializer: {
      indexes: null,
    },
  };

  try {
    const response = await axios.get(url, config);
    console.log(response.data);
  } catch (error) {
    console.error(error);
  }
}

Returns

200
400
GetLeaderboardSummaryResponseDto object
Leaderboard summary: liquidity, makers, and performance for the period
liquidity
* any
Global liquidity stats (point-in-time, independent of `period`).
allOf[0]
LeaderboardSummaryLiquidityDto object
Leaderboard liquidity summary: total shared and pullable liquidity
shared
* any
Total shared liquidity across all open strategies on all chains, in USD. Point-in-time, independent of `period`; counts whitelisted tokens only. null when unavailable.
allOf[0]
LiquidityUsdDto object
USD value summed over priced tokens; null when no in-scope token is priced
usd
* number
USD value, summed over priced tokens only — in-scope tokens without a usable current price are skipped. null only when no in-scope token is priced.
pullable
* any
Total pullable liquidity across all open strategies on all chains, in USD. Point-in-time, independent of `period`; counts whitelisted tokens only. null when unavailable.
allOf[0]
LiquidityUsdDto object
USD value summed over priced tokens; null when no in-scope token is priced
usd
* number
USD value, summed over priced tokens only — in-scope tokens without a usable current price are skipped. null only when no in-scope token is priced.
makers
* any
Liquidity-provider counts (point-in-time, independent of `period`).
allOf[0]
LeaderboardSummaryMakersDto object
Count of distinct makers with at least one open strategy
total
* number
Distinct makers with at least one open strategy on any chain (the "Liquidity providers" tile) — point-in-time, not window-scoped. 0 when leaderboard data has not been computed yet.
performance
* any
Window-scoped performance metrics for the selected `period`.
allOf[0]
LeaderboardSummaryPerformanceDto object
Leaderboard performance summary: volume and APY for the period
volume
* any
Swapped volume for the selected period with the per-chain breakdown
allOf[0]
LeaderboardSummaryVolumeDto object
Total swapped volume for the period with per-chain breakdown
usd
* number
Total swapped volume in USD for the selected period, over all makers and all chains. null when the period has no ranked makers or leaderboard data has not been computed yet.
networks
* array
Per-chain breakdown of the same total (the "Volume by network" donut) — sorted by volume descending, chains with zero volume omitted. Empty when leaderboard data has not been computed yet.
items
LeaderboardSummaryNetworkVolumeDto object
Per-chain swapped volume with its share of the total
chainId
* number (Enum)
EVM chain id
1
56
137
42161
10
43114
324
100
8453
59144
146
130
4663
143
25
999
volume
* any
Swapped volume on this chain for the selected period
allOf[0]
LeaderboardSummaryNetworkVolumeUsdDto object
Swapped volume on a chain in USD for the selected period
usd
* number
Swapped volume on the chain in USD for the selected period
share
* number
Fraction (0..1) of the total window volume (`performance.volume.usd`) swapped on this chain
apy
* any
APY highlights for the selected period
allOf[0]
LeaderboardSummaryApyDto object
APY highlights for the selected period
top
* number
Highest maker-level APY (percent) for the selected period across all makers — annualized fee yield computed from collected fees relative to the wallet-backed capital the maker had at work: each position counts only what the wallet held and had approved when it opened, the same balance behind several positions counts once, and the amount is weighted by the time it was deployed. Considers only makers with at least $1,000 of that working capital in strategies older than 72 hours; null when no maker qualifies or the value is not yet computable.
JSON
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
{
  "liquidity": {
    "shared": {
      "usd": 12345.67
    },
    "pullable": {
      "usd": 12345.67
    }
  },
  "makers": {
    "total": 128
  },
  "performance": {
    "volume": {
      "usd": 25271456.12,
      "networks": [
        {
          "chainId": 1,
          "volume": {
            "usd": 1234567.89
          },
          "share": 0.25
        }
      ]
    },
    "apy": {
      "top": 42.5
    }
  }
}

Did you find what you need?