Get maker activity feed across all strategies

Returns a paginated activity feed across all strategies of the maker address, optionally scoped to specific chains via `chainId` (all chains when omitted) and to specific activity types via `type` (all types when omitted). Each item is one transaction of one strategy classified as `open` (strategy shipped), `close` (strategy docked) or `swap`, tagged with the `chainId`, `app` and `strategyHash` of the strategy it belongs to, with the per-token net incoming/outgoing flow. Items are ordered chronologically by `(time, chainId, blockNumber, transactionIndex)` per the `sort` query param.

GEThttps://api.1inch.com/aqua/v1.0/strategies/makers/{address}/activity
Supported on:
EthereumBaseBNB ChainAvalancheZKsyncGnosisOptimismPolygonLineaSonicUnichainRobinhoodArbitrum

Parameters

address
* string path
Maker wallet address
sort
string (Enum)query
Chronological ordering of activities by `(time, chainId, blockNumber, transactionIndex)`
cursor
string query
Pagination cursor from the `nextCursor` field of the previous response; omit to start from the first page
limit
number query
Maximum number of activities to return per page
type
array query
Filter by activity type as a repeatable param (e.g. `?type=open&type=swap`); returns all types when omitted
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
26
27
const axios = require('axios');

async function httpCall() {
  const url =
    'https://api.1inch.com/aqua/v1.0/strategies/makers/{address}/activity';

  const config = {
    headers: {
      Authorization: `Bearer ${API_KEY}`,
    },
    params: {
      limit: 100,
      type: ['swap'],
    },
    paramsSerializer: {
      indexes: null,
    },
  };

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

Returns

200
400
GetMakerActivityResponseDto object
Paginated page of maker activities with cursors for adjacent pages
items
* array
Page of maker activities across all of the maker’s strategies, ordered chronologically by `(time, chainId, blockNumber, transactionIndex)` per the `sort` param
items
MakerActivityDto object
Single maker activity: open, close, or swap with balance changes and price, tagged with the strategy it belongs to
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
total
* number
Approximate total number of activities for the maker in the requested chain scope, independent of the page. Served from a short-lived cache, so it can briefly lag `items` after new activity or a chain reorg; rely on `nextCursor`, not `total`, to detect the end of the list
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
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
38
{
  "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"
      }
    }
  ],
  "total": 1234,
  "nextCursor": "eyJtYWtlciI6IjB4MTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMSIsImNoYWluSWRzIjpudWxsLCJzb3J0IjoiZGVzYyIsImxhc3RQb3NpdGlvbiI6eyJ0aW1lIjoxNzA1Mjc2ODAwMDAwLCJjaGFpbklkIjoxLCJibG9ja051bWJlciI6MjAxMjM0NTYsInRyYW5zYWN0aW9uSW5kZXgiOjUsInN0cmF0ZWd5SWQiOiI0MiJ9LCJkaXJlY3Rpb24iOiJuZXh0In0",
  "prevCursor": "eyJtYWtlciI6IjB4MTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMSIsImNoYWluSWRzIjpudWxsLCJzb3J0IjoiZGVzYyIsImxhc3RQb3NpdGlvbiI6eyJ0aW1lIjoxNzA1Mjc2ODAwMDAwLCJjaGFpbklkIjoxLCJibG9ja051bWJlciI6MjAxMjAwMDAsInRyYW5zYWN0aW9uSW5kZXgiOjIsInN0cmF0ZWd5SWQiOiI0MiJ9LCJkaXJlY3Rpb24iOiJwcmV2In0"
}

Did you find what you need?