Maker volume history time series
Returns a paginated, time-bucketed series of the maker’s incoming volume in USD, aggregated over all of the maker’s strategies. 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 Polygon Linea Sonic Unichain Robinhood Arbitrum Avalanche ZKsync Gnosis Optimism
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/volume';
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 volume-history buckets with navigation cursors
items
* array Page of volume-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
HistoryVolumeBucketDto object One time bucket of the maker volume history series
timestamp
* number Bucket start time as Unix timestamp in seconds (UTC, aligned by granularity)
usd
* number Incoming volume in USD for this bucket, summed over all of the maker’s strategies in the requested chain scope (bucket window aligned by `granularity`, UTC). `0` when the bucket lies inside the maker’s activity window but has no transfers. `null` when the bucket has transfers but no USD price is available for *any* of the involved tokens. When some transfers in the bucket are priced and others are not, the value is the sum over the priced subset only.
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,
"usd": 12345.678901
}
],
"nextCursor": "eyJtYWtlciI6IjB4Li4uIiwic29ydCI6ImRlc2MiLCJkaXJlY3Rpb24iOiJuZXh0In0",
"prevCursor": "eyJtYWtlciI6IjB4Li4uIiwic29ydCI6ImRlc2MiLCJkaXJlY3Rpb24iOiJwcmV2In0"
}