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

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.

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