Retrieves historical daily metrics for the specified pair (for example DAI_WETH).
Protocols Supported
This endpoints supports Uniswap v2, Uniswap v3 and Sushiswap.
This endpoint does not support Curve or Balancer.
Blockchains Supported
This endpoint only supports data from
ethereum-mainnet
.
Time Range Limit
The maximum time range (difference between endDate and startDate) is 30 days.
Not specifying startDate and endDate
If the startDate and endDate query parameters are not provided, the API will return daily data from the previous 1 month.
Response Data
Field | Type | Description |
---|---|---|
exchangeId | string | The id of the exchange. |
timestamp | number | string | The timestamp associated with this record. |
feesNative | number | Total amount of fees paid during that period of time, in native currency. |
feesUSD | number | Total amount of fees paid during that period of time, in USD. |
liquidityTotalNative | number | Total liquidity for the asset (aka total value locked (TVL)), in native currency. |
liquidityTotalUSD | number | Total liquidity for the asset (aka total value locked (TVL)), in USD. |
pairsTradedTotal | number | Total number of pairs which were traded during that period of time. |
tradesTotal | number | Total number of trades during that period of time. |
volumeTotalNative | number | Total volume traded during that period of time, in native currency. |
volumeTotalUSD | number | Total volume traded during that period of time, in USD. |
Response data when a pair is not traded
If a pair is not traded on a specific day, then you may see a response like so
{ "exchangeId": null, "feesNative": 0, "feesUSD": 0, "liquidityTotalNative": "406.1438350000000000", "liquidityTotalUSD": 903.7249475354522, "volumeTotalUSD": 0, "volumeTotalNative": null, "pairsTradedTotal": null, "tradesTotal": null, "timestamp": "2022-09-01 00:00:00 000" }
Even though there were no trades as seen by
"tradesTotal": null
, there could be liquidity events, hence why the response will still return liquidity totals.