Pairs Historical

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

FieldTypeDescription
exchangeIdstringThe id of the exchange.
timestampnumber | stringThe timestamp associated with this record.
feesNativenumberTotal amount of fees paid during that period of time, in native currency.
feesUSDnumberTotal amount of fees paid during that period of time, in USD.
liquidityTotalNativenumberTotal liquidity for the asset (aka total value locked (TVL)), in native currency.
liquidityTotalUSDnumberTotal liquidity for the asset (aka total value locked (TVL)), in USD.
pairsTradedTotalnumberTotal number of pairs which were traded during that period of time.
tradesTotalnumberTotal number of trades during that period of time.
volumeTotalNativenumberTotal volume traded during that period of time, in native currency.
volumeTotalUSDnumberTotal 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.

Language
Credentials
Header
Click Try It! to start a request and see the response here!