get https://api.amberdata.com/market/defi/liquidity//historical
Retrieves the historical (time series) liquidity for the specified pair.
Protocols Supported
This endpoint only supports Uniswap v2, Uniswap v3, Sushiswap and Balancer.
Note: For Balancer, we currently do not calculate
liquidityPrice.
Blockchains Supported
This endpoint only supports data from
ethereum-mainnet.
Time Range Limit
The maximum time range (difference between endDate and startDate) is 1 day.
Not specifying startDate and endDate
If the startDate and endDate query parameters are not provided, the API will return the data from the previous 24 hours.
Response Data
| Field | Type | Description |
|---|---|---|
| metadata | object | The metadata associated with the data. |
| metadata.exchangeId | string | The address of the exchange/pool. |
| metadata.exchangeName | string | The name of the exchange (if available). |
| metadata.pair | string | The common name for the pair - name is not unique, use pairAddress instead). |
| metadata.pairNormalized | string | The internal name for the pair - name is not unique, use pairAddress instead). |
| metadata.pairAddress | string | The address of the pair. |
| metadata.baseAddress | string | The address of the first underlying assert behind the pair. |
| metadata.quoteAddress | string | The address of the last underlying assert behind the pair. |
| data | object | The liquidity data. |
| data.exchangeId | string | The address of the exchange/pool. |
| data.pairAddress | string | The address of the pair. |
| data.timestamp | string | The timestamp associated with this record. |
| data.transactionHash | string | The hash of the transaction which included this liquidity event. |
| data.transactionIndex | number | The index of the transaction which included this liquidity event. |
| data.logIndex | number | The index of the log within the transaction which included this liquidity event. |
| data.amount | number | The new amount of the underlying asset after this liquidity event. |
| data.liquidityPrice | number | The new price of the underlying asset after this liquidity event. |