List all currently open strategies across every maker, with pagination

Returns a cursor-paginated list of all currently open strategies across every maker, optionally filtered by application address and chains

GEThttps://api.1inch.com/aqua/v1.0/strategies/opened
Supported on:
EthereumBaseBNB ChainZKsyncGnosisOptimismPolygonLineaSonicUnichainRobinhoodArbitrumAvalanche

Parameters

cursor
string query
Pagination cursor from the `nextCursor` field of the previous response; omit to start from the first page
limit
number query
Page size
sort
string (Enum)query
Sort direction by block number
app
string query
Filter by app address
chainIds
array query
Filter by chain ids. 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
28
const axios = require('axios');

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

  const config = {
    headers: {
      Authorization: `Bearer ${API_KEY}`,
    },
    params: {
      limit: 100,
      sort: 'desc',
      app: '0x111111125421ca6dc452d289314280a0f8842a65',
      chainIds: [1, 137],
    },
    paramsSerializer: {
      indexes: null,
    },
  };

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

Returns

200
400
GetOpenedStrategiesResponseDto object
Paginated page of opened strategies with cursors for adjacent pages
items
* array
Page of opened strategies matching the query
items
OpenedStrategyDto object
Opened strategy identity, configuration, and tracked tokens
chainId
* number
Chain id
maker
* string
Maker wallet address that owns the strategy
app
* string
Application contract address that manages the strategy
strategyHash
* string
Keccak-256 hash of the strategy configuration
strategyBytes
* string
ABI-encoded strategy configuration bytes, null when omitted (see strategyBytesOmittedReason)
strategyBytesOmittedReason
* string (Enum)
Reason strategyBytes was omitted (null), or null when served. SIZE_EXCEEDS_LIMIT means the stored bytes exceed this service's configured serving limit (currently 40960 bytes); strategyBytesSize always reports the real stored size regardless. To get the full bytes for an omitted strategy, fetch them from the on-chain Shipped event for this strategyHash.
SIZE_EXCEEDS_LIMIT
strategyBytesSize
* number
Raw stored strategy bytes length, in bytes (not hex-string length)
openedAt
* number
Strategy open time, unix seconds
tokens
* array
Tokens tracked by the strategy
items
OpenedStrategyTokenDto object
Token tracked by an opened strategy with balances and allowance
address
* string
Token contract address
balance
* any
Token balances held by the strategy contract and the maker wallet
allOf[0]
OpenedStrategyTokenBalanceDto object
Token balances held by the strategy contract and the maker wallet
strategy
* string
Token balance held by the strategy contract, raw decimal string
wallet
* string
Token balance held by the maker wallet, raw decimal string or null
allowance
* string
Allowance the maker has granted to the strategy, raw decimal string or null
total
* number
Approximate total number of opened strategies matching the query, independent of the page slice and sort. Served from a short-lived cache, so it can briefly lag `items` after a strategy is opened or closed or after 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
{
  "items": [
    {
      "chainId": 1,
      "maker": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
      "app": "0x111111125421ca6dc452d289314280a0f8842a65",
      "strategyHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
      "strategyBytes": "0x0000000000000000000000001234...",
      "strategyBytesOmittedReason": "SIZE_EXCEEDS_LIMIT",
      "strategyBytesSize": 128,
      "openedAt": 1700000000,
      "tokens": [
        {
          "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
          "balance": {
            "strategy": "1000000000000000000",
            "wallet": "500000000000000000"
          },
          "allowance": "1000000000000000000"
        }
      ]
    }
  ],
  "total": 1234,
  "nextCursor": "string",
  "prevCursor": "eyJzb3J0IjoiZGVzYyIsImRpcmVjdGlvbiI6InByZXYifQ"
}

Did you find what you need?