Notus API
Liquidity pools

Get Pool Historical Data

Get detailed historical data for a specific pool including volume and fees over time

GET
/api/v1/liquidity/pools/{id}/historical-data

Authorization

x-api-key<token>

In: header

Path Parameters

idstring

The unique identifier of the pool

Length1 <= length

Query Parameters

rangeInDays?integer

Number of days to look back for statistics (maximum 365 days)

Default30
Range0 < value <= 365
groupByInterval?string

Interval for grouping pool statistics. HOURLY, DAILY, WEEKLY, MONTHLY or YEARLY

Default"DAILY"
Value in"HOURLY" | "DAILY" | "WEEKLY" | "MONTHLY" | "YEARLY"

Response Body

curl -X GET "https://api.notus.team/api/v1/liquidity/pools/137-0x4CcD010148379ea531D6C587CfDd60180196F9b1/historical-data?rangeInDays=30&groupByInterval=DAILY"
{
  "statistics": {
    "rangeInDays": 30,
    "groupByInterval": "DAILY",
    "poolId": "137-0x4CcD010148379ea531D6C587CfDd60180196F9b1",
    "items": [
      {
        "timestamp": 1678900000000,
        "volumeInUSD": "15000.50",
        "feesInUSD": "750.25",
        "closeInUSD": "0.00036046617504367228",
        "highInUSD": "0.00038494169673061318",
        "lowInUSD": "0.00035904368570694481",
        "totalValueLockedInUSD": "500000.75",
        "token0PriceInToken1": "1.25",
        "token1PriceInToken0": "1.25"
      }
    ]
  }
}
{
  "statusCode": 403,
  "id": "UNAVAILABLE_COMPUTE_UNITS",
  "message": "The project doesn't have enough compute units to perform this action. Please upgrade your plan."
}

Get Liquidity Pool GET

Get liquidity pool by pool ID with aggregated stats

List Liquidity Pools GET

List liquidity pools that exist on the blockchain. The pool can be in a broken state, like having nearly no liquidity. Use the data returned by this endpoint to asses if the pool is worth investing into. Choose the aggregation interval to control both granularity and time range: DAILY (last 30 days), WEEKLY (last 12 weeks), MONTHLY (last 12 months).