Maker liquidity history time series
Returns a paginated, time-bucketed series of the maker’s liquidity as of each bucket end: total shared liquidity and the withdrawable (pullable) part, in USD. 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 Avalanche ZKsync Gnosis Optimism Polygon Linea Sonic Unichain Robinhood Chain Arbitrum
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/liquidity';
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
Paginated page of maker liquidity-history buckets with navigation cursors
items
* array Page of liquidity-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
HistoryLiquidityBucketDto object One time bucket of the maker liquidity history series (as of the bucket end)
timestamp
* number Bucket start time as Unix timestamp in seconds (UTC, aligned by granularity)
allOf[0]
HistoryLiquidityAmountDto object USD amount of one liquidity metric as of a bucket end
usd
* number Liquidity value in USD; `null` when it cannot be computed for this bucket
pullable
* any Liquidity withdrawable by the maker as of the end of this bucket: the positive net balances committed to open positions, per token, capped by the wallet balance and approval as of the bucket end; the current bucket uses the live wallet state. Tokens with no wallet history at that time are skipped; `null` when nothing is computable.
allOf[0]
HistoryLiquidityAmountDto object USD amount of one liquidity metric as of a bucket end
usd
* number Liquidity value in USD; `null` when it cannot be computed for this bucket
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
{
"items": [
{
"timestamp": 1705276800,
"shared": {
"usd": 100000.123456
},
"pullable": {
"usd": 100000.123456
}
}
],
"nextCursor": "eyJtYWtlciI6IjB4Li4uIiwic29ydCI6ImRlc2MiLCJkaXJlY3Rpb24iOiJuZXh0In0",
"prevCursor": "eyJtYWtlciI6IjB4Li4uIiwic29ydCI6ImRlc2MiLCJkaXJlY3Rpb24iOiJwcmV2In0"
}