Maker APY history time series
Returns a paginated, time-bucketed series of the maker’s continuous track-record annualized yield in percent as of each bucket end: cumulative fees since inception over the deployed capital, across every strategy ever created (closed ones stay in with frozen fees and lifespan). Buckets are aligned to UTC by `granularity` and span the maker’s activity window (first strategy created to now, or to the last strategy closure). Scoped to specific chains via `chainId`; all chains are aggregated when omitted. Pagination cursors are bound to this endpoint and its request dimensions and are not interchangeable with the other history endpoints.
Supported on: Ethereum Base BNB Chain Robinhood Arbitrum Avalanche ZKsync Gnosis Optimism Polygon Linea Sonic Unichain
Parameters
address
* string pathStrategy creator address
granularity
string (Enum)queryBucket size (UTC-aligned). Defaults to `1d`. Weekly buckets (`1w`) follow the ISO week: Monday start.
sort
string (Enum)queryOrdering of the buckets by their timestamp. Defaults to `desc` (newest first).
cursor
string queryPagination cursor from the `nextCursor` field of the previous response; omit to start from the first page
limit
number queryMaximum number of buckets 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}/history/apy';
const config = {
headers: {
Authorization: `Bearer ${API_KEY}`,
},
params: {
limit: 30,
},
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 APY-history buckets with navigation cursors
items
* array Page of APY-history buckets for the maker, ordered by `timestamp` per the `sort` query param. Empty when the maker has no strategies in the requested chain scope.
items
HistoryApyBucketDto object One time bucket of the maker APY history series
timestamp
* number Bucket start time as Unix timestamp in seconds (UTC, aligned by granularity)
apy
* number The maker’s continuous track-record annualized yield in percent as of the end of this bucket: cumulative fees since each strategy’s inception over the wallet-backed capital at work — what the wallet held and had approved when each position opened — weighted across EVERY strategy created by then — closed strategies stay in the curve with their fees and lifespan frozen at closure, so closing positions never resets the series (unlike the maker stats endpoint, which reflects open positions only). A bucket without new volume carries the running yield; `null` only before the maker’s first qualifying strategy exists
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
{
"items": [
{
"timestamp": 1705276800,
"apy": 12.345678
}
],
"nextCursor": "eyJtYWtlciI6IjB4Li4uIiwic29ydCI6ImRlc2MiLCJkaXJlY3Rpb24iOiJuZXh0In0",
"prevCursor": "eyJtYWtlciI6IjB4Li4uIiwic29ydCI6ImRlc2MiLCJkaXJlY3Rpb24iOiJwcmV2In0"
}