Total Value Locked (TVL)

What is this endpoint for?

This endpoint receives information on the Total Value Locked (TVL) of all DeFi protocols covered by Kaiko.

Endpoint

https://us.market-api.kaiko.io/v2/data/tvl/

Parameters

Parameter	Required	Description	Example
protocol	No	The desired protocol code. If not specified, the endpoint will return the list of all protocol codes.	aave
start_date	No	Starting date in YYYYMMDD (inclusive).	20230125
end_date	No	Ending date in YYYYMMDD (exclusive).	20230126
page_size	No	See Pagination Minimum: 1 Maximum: 1000 Default: 1000	100
sort	No	If asc, sort time-series in ascending. If desc, sort time-series in descending. Default: desc	asc

Fields

Field	Description	Example
timestamp	Timestamp at which the interval begins.	1763856000
protocol_name	Protocol name.	Aave
protocol_code	Protocol code.	aave
tvl	Total value locked (TVL) in USD.	5.04046e+10

Request examples

cURL

curl --compressed -H 'Accept: application/json' -H 'X-Api-Key: <client-api-key>' \
'https://us.market-api.kaiko.io/v2/data/tvl?start_date=20251001&protocol=aave'

Python

Response example

{
    "query":
    {
        "protocol": "aave",
        "start_date": "seconds:1759276800",
        "end_date": "seconds:1764028800",
        "sort": "desc",
        "page_size": "1"
    },
    "time": "2025-11-25T10:20:15.37953193Z",
    "timestamp": 1764066015,
    "data":
    [
        {
            "timestamp": 1763856000,
            "protocol_name": "Aave",
            "protocol_code": "aave",
            "tvl": 50404639283.57133
        }
        /** Results **/
    ],
    "continuation_token": "xxx",
    "next_url": "https://eu.market-api.kaiko.io/v2/data/tvl?continuation_token=xxx"
}