Top movers by volume change

Returns the makers who climbed the most positions on the leaderboard over the last 24 hours, aggregated across all supported chains. `rankDelta` (24h-ago rank minus current rank) is the membership rule and the primary ordering key: only climbers (`rankDelta > 0`) ranked both now and a day ago appear, ordered by positions climbed descending with ties broken by `volumeDelta.usd` descending. `volumeDelta.usd` and `relativeChange` are supporting context: the signed change of the selected rolling window versus 24 hours ago, absolute and as a fraction of the day-ago volume. Makers with meaningful day-ago volume only; decliners and makers that first became active within the last day are not listed. `period=all` is rejected. Rankings refresh continuously (typically within minutes); the list is empty until a full day of leaderboard history exists, or when nobody climbed during a calm period.

GEThttps://api.1inch.com/aqua/v1.0/leaderboard/movers
Supported on:
EthereumBaseBNB ChainGnosisOptimismPolygonLineaSonicUnichainRobinhoodArbitrumAvalancheZKsync

Parameters

period
string (Enum)query
limit
number query

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
24
25
26
const axios = require('axios');

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

  const config = {
    headers: {
      Authorization: `Bearer ${API_KEY}`,
    },
    params: {
      period: '7d',
      limit: 3,
    },
    paramsSerializer: {
      indexes: null,
    },
  };

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

Returns

200
400
GetLeaderboardMoversResponseDto object
items
* array
items
LeaderboardMoverDto object
maker
* string
volumeDelta
* any
allOf[0]
LeaderboardMoverVolumeDeltaDto object
usd
* number
relativeChange
* number
rankDelta
* number
JSON
1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "items": [
    {
      "maker": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
      "volumeDelta": {
        "usd": 1250000.5
      },
      "relativeChange": 4.2,
      "rankDelta": 2
    }
  ]
}

Did you find what you need?