Protocol TVL history API

Daily TVL time-series for a protocol over a trailing window with start/current/peak values and percent change. Sourced from DefiLlama /protocol/{slug} tvl series. Answers 'how has Lido TVL trended','what was the peak TVL in the last 90 days'.

Price$0.01per request

MethodPOST

Route/v1/defi/tvl-history

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

defitvlhistorytimeseriestrendprotocoldefillamachart

API URLhttps://x402.hexl.dev/v1/defi/tvl-history

Integration docs

Example request

{
  "protocol": "lido",
  "days": 7
}

Example response

{
  "name": "Lido",
  "days": 7,
  "currentTvlUsd": 16170641589,
  "windowStartTvlUsd": 17830570086,
  "changePct": -9.31,
  "peakTvlUsd": 17907241355,
  "history": [
    {
      "date": 1779926400,
      "dateIso": "2026-05-27",
      "tvlUsd": 17830570086
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "protocol"
  ],
  "properties": {
    "protocol": {
      "type": "string",
      "examples": [
        "lido",
        "aave",
        "uniswap"
      ]
    },
    "days": {
      "type": "number",
      "minimum": 1,
      "maximum": 3650,
      "default": 90
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}