List the newest swaps across all makers (paginated)

Returns the newest swaps across all makers, optionally scoped to specific chains via `chainId` (all chains when omitted). Each item is one transaction of one strategy that moved the strategy’s tokens without opening or closing it, in the same shape as a `swap` item of the maker activity feed plus the `maker` that owns the strategy; a transaction that swaps through several strategies yields one item per strategy. Items are ordered newest first by `time`, then chain id, block number, transaction index and strategy, all descending; follow `nextCursor` for older swaps. USD values are reported only for tokens whitelisted for leaderboard pricing and are null for other tokens. Reads live indexed data, so a swap is listed as soon as it is indexed.

GEThttps://api.1inch.com/aqua/v1.0/leaderboard/swaps
Supported on:
EthereumBaseBNB ChainAvalancheZKsyncGnosisOptimismPolygonLineaSonicUnichainRobinhood ChainArbitrum

Parameters

cursor
string query
Pagination cursor from the `nextCursor` field of the previous response, valid only with the same `chainId` set it was issued for; omit to start from the newest swap
limit
number query
Maximum number of swaps to return per page
chainId
array query
Filter by chain IDs as a number array (e.g. `?chainId=1&chainId=137`); returns all chains when omitted. Values are deduplicated and sorted server-side; at most 100 values per request, more returns 400.

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

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

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

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

Returns

GetLeaderboardSwapsResponseDto object
Page of the newest swaps across all makers with a cursor for the next, older page
items
* array
Swaps across all makers in the requested chain scope, newest first: ordered by `time`, then chain id, block number, transaction index and strategy, all descending
items
LeaderboardSwapDto object
Single swap of the global feed: the same item as a `swap` of the maker activity feed (`type` is always `swap`), plus the maker that owns the strategy
chainId
* number
EVM chain id of the strategy the activity belongs to
txHash
* string
Transaction hash of the activity
app
* string
Application contract address that manages the strategy the activity belongs to
strategyHash
* string
Keccak-256 hash of the strategy the activity belongs to (0x-prefixed 32-byte hex)
type
* string (Enum)
Activity type: `open` (strategy shipped), `close` (strategy docked) or `swap`
open
close
swap
time
* number
Block timestamp of the transaction as Unix seconds (UTC)
balanceChanges
* array
Per-token net balance changes within the transaction; for a `close` the final strategy balances released at the dock, reported as outgoing flow
items
BalanceChangeDto object
Per-token net balance change within a transaction
token
* string
Token address involved in the change
in
* any
Net amount of the token received by the strategy in this transaction
allOf[0]
TokenFlowDto object
Token amount flow, raw and in USD
raw
* string
Raw token amount (integer string in base units, no decimals)
usd
* number
USD value of the amount; null when no USD price is indexed for the token at that block
out
* any
Net amount of the token sent by the strategy in this transaction
allOf[0]
TokenFlowDto object
Token amount flow, raw and in USD
raw
* string
Raw token amount (integer string in base units, no decimals)
usd
* number
USD value of the amount; null when no USD price is indexed for the token at that block
fee
*TokenFlowDto object
Token amount flow, raw and in USD
raw
* string
Raw token amount (integer string in base units, no decimals)
usd
* number
USD value of the amount; null when no USD price is indexed for the token at that block
price
* object
Execution price of the transaction (quote token per one base token); null when the transaction is not a two-token exchange or token data is unavailable
allOf[0]
ActivityPriceDto object
Execution price of a transaction (quote per base) with USD value
value
* string
Human-readable execution price of the transaction (quote token per one base token)
usd
* number
USD value of one base token at the transaction block; null when the quote token is unpriced
quoteSymbol
* string
Symbol of the quote token
maker
* string
Address of the maker that owns the strategy the swap went through
nextCursor
* string
Opaque cursor to pass as `cursor` query param to fetch the next, older page; null when there are no more results
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
{
  "items": [
    {
      "chainId": 1,
      "txHash": "0x7ceddea4b5d7109e0eeab34ae9473e3e868f04034f60922c51abf731319f0a68",
      "app": "0x111111125421ca6dc452d289314280a0f8842a65",
      "strategyHash": "0x84c02b6ac9dbfb965f0f8f10d4a851d4b30e35cbcf2405bbdc19b8ede8d84118",
      "type": "swap",
      "time": 1705276800,
      "balanceChanges": [
        {
          "token": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
          "in": {
            "raw": "10000000",
            "usd": 9.99
          },
          "out": {
            "raw": "10000000",
            "usd": 9.99
          },
          "fee": {
            "raw": "10000000",
            "usd": 9.99
          }
        }
      ],
      "price": {
        "value": "2345.67",
        "usd": 2345.67,
        "quoteSymbol": "USDC"
      },
      "maker": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
    }
  ],
  "nextCursor": "eyJjaGFpbklkcyI6bnVsbCwibGFzdFBvc2l0aW9uIjp7InRpbWUiOjE3NjAwMDAwMDAwMDAsImNoYWluSWQiOjEsImJsb2NrTnVtYmVyIjoyMzAwMDAwMCwidHJhbnNhY3Rpb25JbmRleCI6NSwic3RyYXRlZ3lJZCI6IjQyIn19"
}

Did you find what you need?