List a maker's strategies (paginated)
Returns a cursor-paginated list of strategies owned by the maker address, optionally filtered by status and chain
Supported on: Ethereum Base BNB Chain Polygon Linea Sonic Unichain Robinhood Arbitrum Avalanche ZKsync Gnosis Optimism
Parameters
address
* string pathStrategy creator address
cursor
string queryPagination cursor from the `nextCursor` field of the previous response; omit to start from the first page
status
array queryFilter by strategy status. "open" returns active and illiquidity strategies; "closed" returns docked strategies. Defaults to ["open"] when omitted. Pass both values to return all strategies
limit
number queryMaximum number of strategies to return per page
chainId
array queryFilter 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.
JavaScript
Copy
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/strategies/makers/{address}';
const config = {
headers: {
Authorization: `Bearer ${API_KEY}`,
},
params: {
status: ['open'],
limit: 20,
},
paramsSerializer: {
indexes: null,
},
};
try {
const response = await axios.get(url, config);
console.log(response.data);
} catch (error) {
console.error(error);
}
}
Returns
200
400
Paginated page of maker strategies with cursors for adjacent pages
items
* array Page of strategies matching the query
items
StrategyDto object Maker strategy with tokens, classification, and performance data
chainId
* number EVM chain ID where the strategy was deployed
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 Unix timestamp (seconds) when the strategy was opened (Shipped event)
closedAt
* number Unix timestamp (seconds) when the strategy was closed (Docked event); null if still open
tokens
* array Tokens tracked by this strategy with balance and price data
items
StrategyTokenDto object Token tracked by a strategy with balances, wallet data, and performance
address
* string ERC-20 token contract address (checksummed hex)
meta
* object Token metadata; null when the token is not indexed
allOf[0]
TokenMetaDto object ERC-20 token metadata (decimals, symbol, name, logo)
decimals
* number Token decimal places
symbol
* string Token ticker symbol
name
* string Full token name
logoURI
string URL of the token logo image
initialBalance
* any Token balance at the time the strategy was opened (shipped)
allOf[0]
TokenInitialBalanceDto object Token balance allocated to the strategy at creation time with its USD value
raw
* string Raw token amount allocated to the strategy at the time of its creation (integer string, no decimals)
usd
* number USD value of the initial balance at strategy ship time; null when price data is unavailable
currentBalance
* any Current token balance held by the strategy contract
allOf[0]
TokenCurrentBalanceDto object Current token balance of the strategy contract with its USD value
raw
* string Raw token amount currently allocated to the strategy (integer string, no decimals)
usd
* number Current USD value of the balance; null when price data is unavailable
wallet
* any Maker wallet balance and allowance for this token
allOf[0]
WalletDto object Maker wallet balance and allowance for a token
balance
* any Maker wallet balance for the token
allOf[0]
WalletBalanceDto object Maker wallet token balance with its USD value
raw
* string Raw wallet token balance (integer string, no decimals); null when not yet indexed
usd
* number USD value of the wallet balance; null when price data is unavailable or balance not indexed
allowance
* string Maker wallet allowance for the application (integer string); null when not yet indexed
performance
* any Performance metrics (fees, APY)
allOf[0]
PerformanceDto object Strategy performance metrics: fees and incoming volume
fees
* any Fee performance breakdown
allOf[0]
PerformanceFeesDto object Fee performance broken down by time window (total, 24h, 7d, 30d, 90d, 180d)
total
* any All-time fee metrics
allOf[0]
PerformanceFeesPeriodDto object Fee metrics (USD and APY) for a single time window
usd
* number Fees collected in USD for the period. null when no usd price for all tokens in the strategy
apy
* number Annualised fee yield (APY) denominated in Percent for the period. Measured against the wallet-backed capital: the initial balance capped by what the maker held and approved when the position opened, so declared reserves the wallet never covered do not dilute it. null when the fees or that capital are unpriced, when the measured time is under an hour, or when the annualised result carries no information
last24h
* any Fee metrics for the last 24 hours
allOf[0]
PerformanceFeesPeriodDto object Fee metrics (USD and APY) for a single time window
usd
* number Fees collected in USD for the period. null when no usd price for all tokens in the strategy
apy
* number Annualised fee yield (APY) denominated in Percent for the period. Measured against the wallet-backed capital: the initial balance capped by what the maker held and approved when the position opened, so declared reserves the wallet never covered do not dilute it. null when the fees or that capital are unpriced, when the measured time is under an hour, or when the annualised result carries no information
last7d
* any Fee metrics for the last 7 days
allOf[0]
PerformanceFeesPeriodDto object Fee metrics (USD and APY) for a single time window
usd
* number Fees collected in USD for the period. null when no usd price for all tokens in the strategy
apy
* number Annualised fee yield (APY) denominated in Percent for the period. Measured against the wallet-backed capital: the initial balance capped by what the maker held and approved when the position opened, so declared reserves the wallet never covered do not dilute it. null when the fees or that capital are unpriced, when the measured time is under an hour, or when the annualised result carries no information
last30d
* any Fee metrics for the last 30 days
allOf[0]
PerformanceFeesPeriodDto object Fee metrics (USD and APY) for a single time window
usd
* number Fees collected in USD for the period. null when no usd price for all tokens in the strategy
apy
* number Annualised fee yield (APY) denominated in Percent for the period. Measured against the wallet-backed capital: the initial balance capped by what the maker held and approved when the position opened, so declared reserves the wallet never covered do not dilute it. null when the fees or that capital are unpriced, when the measured time is under an hour, or when the annualised result carries no information
last90d
* any Fee metrics for the last 90 days
allOf[0]
PerformanceFeesPeriodDto object Fee metrics (USD and APY) for a single time window
usd
* number Fees collected in USD for the period. null when no usd price for all tokens in the strategy
apy
* number Annualised fee yield (APY) denominated in Percent for the period. Measured against the wallet-backed capital: the initial balance capped by what the maker held and approved when the position opened, so declared reserves the wallet never covered do not dilute it. null when the fees or that capital are unpriced, when the measured time is under an hour, or when the annualised result carries no information
last180d
* any Fee metrics for the last 180 days
allOf[0]
PerformanceFeesPeriodDto object Fee metrics (USD and APY) for a single time window
usd
* number Fees collected in USD for the period. null when no usd price for all tokens in the strategy
apy
* number Annualised fee yield (APY) denominated in Percent for the period. Measured against the wallet-backed capital: the initial balance capped by what the maker held and approved when the position opened, so declared reserves the wallet never covered do not dilute it. null when the fees or that capital are unpriced, when the measured time is under an hour, or when the annualised result carries no information
volume
* any Incoming volume breakdown in USD
allOf[0]
PerformanceVolumeDto object Incoming volume broken down by time window (total, 24h, 7d, 30d, 90d, 180d)
total
* any All-time total incoming volume
allOf[0]
PerformanceVolumePeriodDto object Incoming volume in USD for a single time window
usd
* number Incoming volume in USD for the period. null when no USD price is indexed for any token; otherwise the sum over priced tokens.
last24h
* any Incoming volume for the last 24 hours
allOf[0]
PerformanceVolumePeriodDto object Incoming volume in USD for a single time window
usd
* number Incoming volume in USD for the period. null when no USD price is indexed for any token; otherwise the sum over priced tokens.
last7d
* any Incoming volume for the last 7 days
allOf[0]
PerformanceVolumePeriodDto object Incoming volume in USD for a single time window
usd
* number Incoming volume in USD for the period. null when no USD price is indexed for any token; otherwise the sum over priced tokens.
last30d
* any Incoming volume for the last 30 days
allOf[0]
PerformanceVolumePeriodDto object Incoming volume in USD for a single time window
usd
* number Incoming volume in USD for the period. null when no USD price is indexed for any token; otherwise the sum over priced tokens.
last90d
* any Incoming volume for the last 90 days
allOf[0]
PerformanceVolumePeriodDto object Incoming volume in USD for a single time window
usd
* number Incoming volume in USD for the period. null when no USD price is indexed for any token; otherwise the sum over priced tokens.
last180d
* any Incoming volume for the last 180 days
allOf[0]
PerformanceVolumePeriodDto object Incoming volume in USD for a single time window
usd
* number Incoming volume in USD for the period. null when no USD price is indexed for any token; otherwise the sum over priced tokens.
classification
* any Strategy type and lifecycle state classification
allOf[0]
ClassificationDto object Strategy type and lifecycle state classification
type
* string (Enum)AMM strategy formula type
concentrated
pegged
xyc
unknown
state
* string (Enum)Lifecycle state of the strategy. "active" — open and position is healthy; "illiquidity" — open but maker has insufficient real balance/allowance for the current virtual balance of at least one token; "closed" — strategy was docked
active
illiquidity
closed
feePercent
* number Maker`s flat fee on a strategy. null when the strategy is unknown
performance
* any Performance metrics (fees, APY)
allOf[0]
PerformanceDto object Strategy performance metrics: fees and incoming volume
fees
* any Fee performance breakdown
allOf[0]
PerformanceFeesDto object Fee performance broken down by time window (total, 24h, 7d, 30d, 90d, 180d)
total
* any All-time fee metrics
allOf[0]
PerformanceFeesPeriodDto object Fee metrics (USD and APY) for a single time window
usd
* number Fees collected in USD for the period. null when no usd price for all tokens in the strategy
apy
* number Annualised fee yield (APY) denominated in Percent for the period. Measured against the wallet-backed capital: the initial balance capped by what the maker held and approved when the position opened, so declared reserves the wallet never covered do not dilute it. null when the fees or that capital are unpriced, when the measured time is under an hour, or when the annualised result carries no information
last24h
* any Fee metrics for the last 24 hours
allOf[0]
PerformanceFeesPeriodDto object Fee metrics (USD and APY) for a single time window
usd
* number Fees collected in USD for the period. null when no usd price for all tokens in the strategy
apy
* number Annualised fee yield (APY) denominated in Percent for the period. Measured against the wallet-backed capital: the initial balance capped by what the maker held and approved when the position opened, so declared reserves the wallet never covered do not dilute it. null when the fees or that capital are unpriced, when the measured time is under an hour, or when the annualised result carries no information
last7d
* any Fee metrics for the last 7 days
allOf[0]
PerformanceFeesPeriodDto object Fee metrics (USD and APY) for a single time window
usd
* number Fees collected in USD for the period. null when no usd price for all tokens in the strategy
apy
* number Annualised fee yield (APY) denominated in Percent for the period. Measured against the wallet-backed capital: the initial balance capped by what the maker held and approved when the position opened, so declared reserves the wallet never covered do not dilute it. null when the fees or that capital are unpriced, when the measured time is under an hour, or when the annualised result carries no information
last30d
* any Fee metrics for the last 30 days
allOf[0]
PerformanceFeesPeriodDto object Fee metrics (USD and APY) for a single time window
usd
* number Fees collected in USD for the period. null when no usd price for all tokens in the strategy
apy
* number Annualised fee yield (APY) denominated in Percent for the period. Measured against the wallet-backed capital: the initial balance capped by what the maker held and approved when the position opened, so declared reserves the wallet never covered do not dilute it. null when the fees or that capital are unpriced, when the measured time is under an hour, or when the annualised result carries no information
last90d
* any Fee metrics for the last 90 days
allOf[0]
PerformanceFeesPeriodDto object Fee metrics (USD and APY) for a single time window
usd
* number Fees collected in USD for the period. null when no usd price for all tokens in the strategy
apy
* number Annualised fee yield (APY) denominated in Percent for the period. Measured against the wallet-backed capital: the initial balance capped by what the maker held and approved when the position opened, so declared reserves the wallet never covered do not dilute it. null when the fees or that capital are unpriced, when the measured time is under an hour, or when the annualised result carries no information
last180d
* any Fee metrics for the last 180 days
allOf[0]
PerformanceFeesPeriodDto object Fee metrics (USD and APY) for a single time window
usd
* number Fees collected in USD for the period. null when no usd price for all tokens in the strategy
apy
* number Annualised fee yield (APY) denominated in Percent for the period. Measured against the wallet-backed capital: the initial balance capped by what the maker held and approved when the position opened, so declared reserves the wallet never covered do not dilute it. null when the fees or that capital are unpriced, when the measured time is under an hour, or when the annualised result carries no information
volume
* any Incoming volume breakdown in USD
allOf[0]
PerformanceVolumeDto object Incoming volume broken down by time window (total, 24h, 7d, 30d, 90d, 180d)
total
* any All-time total incoming volume
allOf[0]
PerformanceVolumePeriodDto object Incoming volume in USD for a single time window
usd
* number Incoming volume in USD for the period. null when no USD price is indexed for any token; otherwise the sum over priced tokens.
last24h
* any Incoming volume for the last 24 hours
allOf[0]
PerformanceVolumePeriodDto object Incoming volume in USD for a single time window
usd
* number Incoming volume in USD for the period. null when no USD price is indexed for any token; otherwise the sum over priced tokens.
last7d
* any Incoming volume for the last 7 days
allOf[0]
PerformanceVolumePeriodDto object Incoming volume in USD for a single time window
usd
* number Incoming volume in USD for the period. null when no USD price is indexed for any token; otherwise the sum over priced tokens.
last30d
* any Incoming volume for the last 30 days
allOf[0]
PerformanceVolumePeriodDto object Incoming volume in USD for a single time window
usd
* number Incoming volume in USD for the period. null when no USD price is indexed for any token; otherwise the sum over priced tokens.
last90d
* any Incoming volume for the last 90 days
allOf[0]
PerformanceVolumePeriodDto object Incoming volume in USD for a single time window
usd
* number Incoming volume in USD for the period. null when no USD price is indexed for any token; otherwise the sum over priced tokens.
last180d
* any Incoming volume for the last 180 days
allOf[0]
PerformanceVolumePeriodDto object Incoming volume in USD for a single time window
usd
* number Incoming volume in USD for the period. null when no USD price is indexed for any token; otherwise the sum over priced tokens.
total
* number Approximate total number of strategies for the maker matching the query filters, 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
Copy
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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
{
"items": [
{
"chainId": 1,
"maker": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"app": "0x111111125421ca6dc452d289314280a0f8842a65",
"strategyHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
"strategyBytes": "0x0000000000000000000000001234...",
"strategyBytesOmittedReason": "SIZE_EXCEEDS_LIMIT",
"strategyBytesSize": 128,
"openedAt": 1705312800,
"closedAt": null,
"tokens": [
{
"address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"meta": {
"decimals": 18,
"symbol": "USDC",
"name": "USD Coin",
"logoURI": "https://tokens.1inch.io/0xa0b86991.png"
},
"initialBalance": {
"raw": "1000000000000000000",
"usd": 1234.56
},
"currentBalance": {
"raw": "500000000000000000",
"usd": 617.28
},
"wallet": {
"balance": {
"raw": "500000000000000000",
"usd": 617.28
},
"allowance": "500000000000000000"
},
"performance": {
"fees": {
"total": {
"usd": 12.23,
"apy": 10.25
},
"last24h": {
"usd": 12.23,
"apy": 10.25
},
"last7d": {
"usd": 12.23,
"apy": 10.25
},
"last30d": {
"usd": 12.23,
"apy": 10.25
},
"last90d": {
"usd": 12.23,
"apy": 10.25
},
"last180d": {
"usd": 12.23,
"apy": 10.25
}
},
"volume": {
"total": {
"usd": 25271
},
"last24h": {
"usd": 25271
},
"last7d": {
"usd": 25271
},
"last30d": {
"usd": 25271
},
"last90d": {
"usd": 25271
},
"last180d": {
"usd": 25271
}
}
}
}
],
"classification": {
"type": "concentrated",
"state": "active",
"feePercent": 0.05
},
"performance": {
"fees": {
"total": {
"usd": 12.23,
"apy": 10.25
},
"last24h": {
"usd": 12.23,
"apy": 10.25
},
"last7d": {
"usd": 12.23,
"apy": 10.25
},
"last30d": {
"usd": 12.23,
"apy": 10.25
},
"last90d": {
"usd": 12.23,
"apy": 10.25
},
"last180d": {
"usd": 12.23,
"apy": 10.25
}
},
"volume": {
"total": {
"usd": 25271
},
"last24h": {
"usd": 25271
},
"last7d": {
"usd": 25271
},
"last30d": {
"usd": 25271
},
"last90d": {
"usd": 25271
},
"last180d": {
"usd": 25271
}
}
}
}
],
"total": 1234,
"nextCursor": "string",
"prevCursor": "eyJtYWtlciI6IjB4MTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMSIsImRpcmVjdGlvbiI6InByZXYifQ"
}