Skip to main content

DefiLlama TVL

/api/v1/defillama/tvl

Description​

Get historical Total Value Locked (TVL) data for given protocol and chain parameters.

Method​

GET

Source​

Database

Parameters​

ParameterTypeRequiredDescription
protocolstringnoSpecifies the protocol name.
chainstringnoSpecifies the chain name.

Response Status Codes​

StatusDescription
200 OKSuccess. Returns historical TVL data.

Example: Get historical TVL across all blockchains​

Request​

GET /api/v1/defillama/tvl

Response​

[
  [
    "Date",
    "Usd"
  ],
  [
    "04/27/2018 00:00:00",
    "404077.858810"
  ],
  [
    "04/28/2018 00:00:00",
    "400585.099213"
  ],
  [
    "04/29/2018 00:00:00",
    "429213.933200"
  ],
  [
    "04/30/2018 00:00:00",
    "421651.156158"
  ],
  [
    "05/01/2018 00:00:00",
    "436194.969783"
  ],
  ...
]

Example: Get historical TVL for Lido protocol​

Request​

GET /api/v1/defillama/tvl?protocol=lido

Response​

[
  [
    "Date",
    "Usd"
  ],
  [
    "12/19/2020 23:00:00",
    "1484680.728490"
  ],
  [
    "12/20/2020 23:00:00",
    "2697598.312380"
  ],
  [
    "12/21/2020 23:00:00",
    "3410253.516730"
  ],
  [
    "12/22/2020 23:00:00",
    "4563625.919540"
  ],
  [
    "12/23/2020 23:00:00",
    "4661610.562220"
  ],
  ...
]

Example: Get historical TVL for Bitcoin blockchain​

Request​

GET /api/v1/defillama/tvl?chain=bitcoin

Response​

[
  [
    "Date",
    "Usd"
  ],
  [
    "03/21/2021 00:00:00",
    "64933228.560000"
  ],
  [
    "03/22/2021 00:00:00",
    "65842440.830000"
  ],
  [
    "03/23/2021 00:00:00",
    "62926579.200000"
  ],
  [
    "03/24/2021 00:00:00",
    "62607414.240000"
  ],
  [
    "03/25/2021 00:00:00",
    "60169756.000000"
  ],
  [
    "03/26/2021 00:00:00",
    "60169756.000000"
  ],
  [
    "03/27/2021 00:00:00",
    "63386771.160000"
  ],
  [
    "03/28/2021 00:00:00",
    "64748628.040000"
  ],
  ...
]

Example: Get historical TVL for Lido protocol on Ethereum blockchain​

Request​

GET /api/v1/defillama/tvl?protocol=lido&chain=ethereum

Response​

[
  [
    "Date",
    "Usd"
  ],
  [
    "12/19/2020 23:00:00",
    "1484680.728490"
  ],
  [
    "12/20/2020 23:00:00",
    "2697598.312380"
  ],
  [
    "12/21/2020 23:00:00",
    "3410253.516730"
  ],
  [
    "12/22/2020 23:00:00",
    "4563625.919540"
  ],
  [
    "12/23/2020 23:00:00",
    "4661610.562220"
  ],
  ...
]