List makers ranked by window volume (paginated)
Returns the global race table: makers ranked across all supported chains for the selected window, by swapped USD volume or, via `sortBy`, by APY, pullable or shared liquidity, fees or open positions. Rankings refresh continuously (typically within minutes). Makers with zero window volume are excluded whichever column is selected, so the row set and `total` do not change with `sortBy`.
Supported on: Ethereum Base BNB Chain Optimism Polygon Linea Sonic Unichain Robinhood Arbitrum Avalanche ZKsync Gnosis
Parameters
period
string (Enum)queryLeaderboard timeframe
sortBy
string (Enum)queryColumn to rank by, always descending (best first). The page covers the same makers whichever column is chosen — only the order changes, and makers without a value for the column sort last
cursor
string queryPagination cursor from the `nextCursor` field of the previous response; omit to start from the first page
limit
number queryMaximum number of makers to return per page
maker
string queryExact wallet address — returns the page containing that maker (jump-to-row for search / "You"). Mutually exclusive with `cursor`. When the maker has no volume in the window the page is empty
Request Body
This request doesn’t have any request body.
JavaScript
Copy
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
const axios = require('axios');
async function httpCall() {
const url = 'https://api.1inch.com/aqua/v1.0/leaderboard/makers';
const config = {
headers: {
Authorization: `Bearer ${API_KEY}`,
},
params: {
limit: 20,
maker: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045',
},
paramsSerializer: {
indexes: null,
},
};
try {
const response = await axios.get(url, config);
console.log(response.data);
} catch (error) {
console.error(error);
}
}
Returns
200
400
Paginated page of ranked makers with cursors for adjacent pages
items
* array Page of ranked makers ordered by rank ascending; makers with zero window volume are excluded
items
LeaderboardMakerDto object Ranked leaderboard row for a maker: rank, sortable metrics, share, and movement
rank
* number 1-based global rank across all supported chains, in the ordering selected by `sortBy`
maker
* string Maker wallet address; ENS name and avatar are resolved client-side
volume
* any Swapped USD volume in the selected window, all chains
allOf[0]
LeaderboardVolumeUsdDto object USD volume amount rounded to the configured precision
usd
* number USD amount rounded to the configured USD precision
fees
* any Fees collected in the selected window, all chains
allOf[0]
LeaderboardFeesUsdDto object Fees collected in the selected window; null when no fee rate is known
usd
* number Fees collected in the window across the maker’s strategies on all chains, rounded to the configured USD precision. null when none of the strategies has a known flat fee rate.
apy
* any Maker-level APY for the selected period
allOf[0]
LeaderboardMakerApyDto object Maker-level APY for the selected period
percent
* number Annualized fee yield (percent) for the period — collected fees over the average wallet-backed working capital, aggregated across the maker’s strategies. The board applies anti-distortion guards: null when the maker’s eligible strategies carry less than 72 hours of measured position time or less than $1,000 of average working capital (extrapolating thinner evidence produces six-digit percentages), or when the value is not computable. The maker’s own stats endpoint reports the unguarded measured rate.
liquidity
* any Liquidity the maker backs on-chain, point-in-time
allOf[0]
LeaderboardMakerLiquidityDto object Liquidity metrics of one leaderboard maker: shared (capped per strategy) and pullable (capped per token)
usd
* number Liquidity the maker’s open strategies share, in USD. Point-in-time, independent of `period`; counts whitelisted tokens only. null when unavailable; 0 for a maker with no open strategies.
pullable
* any Shared liquidity the maker backs on-chain and could pull, point-in-time
allOf[0]
LeaderboardPullableLiquidityUsdDto object The maker’s pullable liquidity
usd
* number The maker’s pullable liquidity in USD. Point-in-time, independent of `period`; counts whitelisted tokens only. null when unavailable; 0 for a maker with no open strategies.
rankDelta
* number Rank movement in the selected ordering: previous (24h-ago) rank minus current rank — +2 means climbed two spots. Null for new entrants or while 24h rank history for that ordering is not available
strategies
* any Open strategy counts, for row tooltips
allOf[0]
LeaderboardStrategiesDto object Open strategy counts of a maker
open
* number Number of currently open strategies of the maker across all chains
total
* number Total number of makers ranked in the window, independent of the page slice
nextCursor
* string Opaque cursor to pass as `cursor` query param to fetch the next page; null when there are no more results
prevCursor
* string Opaque cursor for the previous page; null when on the first page
JSON
Copy
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
32
33
34
{
"items": [
{
"rank": 4,
"maker": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"volume": {
"usd": 20400000.123456
},
"fees": {
"usd": 12345.67
},
"apy": {
"percent": 42.5
},
"liquidity": {
"shared": {
"usd": 23456.78
},
"pullable": {
"usd": 12345.67
}
},
"share": 0.042,
"rankDelta": 2,
"strategies": {
"open": 3
}
}
],
"total": 1234,
"nextCursor": "eyJyYW5rIjo0MCwicGVyaW9kIjoiN2QiLCJkaXJlY3Rpb24iOiJuZXh0In0",
"prevCursor": "eyJyYW5rIjoyMSwicGVyaW9kIjoiN2QiLCJkaXJlY3Rpb24iOiJwcmV2In0"
}