Get one maker's leaderboard rank detail

Returns the volume-race rank detail for one maker — the caller’s own row plus the gap to the next rank — together with the maker’s other leaderboard metrics. Responds 200 with `rank: null` (never 404) for a valid address with no volume in the window. For the maker’s place in another ordering, page the makers list with `sortBy` and `maker`.

GEThttps://api.1inch.com/aqua/v1.0/leaderboard/makers/{address}
Supported on:
EthereumBaseBNB ChainRobinhoodArbitrumAvalancheZKsyncGnosisOptimismPolygonLineaSonicUnichain

Parameters

address
* string path
Maker wallet address
period
string (Enum)query
Leaderboard timeframe

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/makers/{address}';

  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
GetLeaderboardMakerResponseDto object
Leaderboard rank detail for a single maker
rank
* number
1-based global rank; null when the maker has no volume in the window (unranked)
maker
* string
Maker wallet address from the request path
volume
* any
Swapped USD volume in the selected window, all chains; 0 when unranked
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; null when unranked
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; null when unranked
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
Point-in-time liquidity: shared (allocated) and pullable (capped by on-chain reality); shared.usd and pullable.usd are null when unranked
allOf[0]
LeaderboardMakerLiquidityDto object
Liquidity metrics of one leaderboard maker: shared (capped per strategy) and pullable (capped per token)
shared
* any
Liquidity the maker’s open strategies declare (allocated, uncapped), point-in-time
allOf[0]
LeaderboardSharedLiquidityUsdDto object
The maker’s shared liquidity
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.
share
* number
Fraction of the total window volume, 0..1; 0 when unranked
rankDelta
* number
Rank movement: previous (24h-ago) rank minus current rank — +2 means climbed two spots. Null for new entrants or while 24h rank history is not yet available
strategies
* any
Open strategy counts
allOf[0]
LeaderboardStrategiesDto object
Open strategy counts of a maker
open
* number
Number of currently open strategies of the maker across all chains
nextRank
* object
The maker one rank above; null when the maker is rank 1 or unranked
allOf[0]
LeaderboardNextRankDto object
The maker one rank above with the volume gap to overtake
rank
* number
Rank of the maker one spot above
maker
* string
Wallet address of the maker one spot above
volume
* any
Window USD volume of the maker one spot above
allOf[0]
LeaderboardVolumeUsdDto object
USD volume amount rounded to the configured precision
usd
* number
USD amount rounded to the configured USD precision
volumeGap
* any
Additional USD volume needed to overtake the maker one spot above
allOf[0]
LeaderboardVolumeUsdDto object
USD volume amount rounded to the configured precision
usd
* number
USD amount rounded to the configured USD precision
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
32
33
34
35
36
37
{
  "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
  },
  "nextRank": {
    "rank": 3,
    "maker": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    "volume": {
      "usd": 20400000.123456
    },
    "volumeGap": {
      "usd": 20400000.123456
    }
  }
}

Did you find what you need?