Token Reserves

What is this endpoint for?

This indicates the amount of each token available for trading in a liquidity pool, identified through its blockchain pool address. A separate endpoint provides this data specifically for Uniswap V3 liquidity pools.

Endpoint

https://eu.market-api.kaiko.io/v2/data/liquidity.v1/snapshots

Parameters

Parameter	Required	Description	Example
blockchain	No	Should be one of the currently supported blockchain.	ethereum
pool_address	Yes	Pool address.	0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7
live	No	Shows the data as soon as the block is validated. (Default: false, in case of block reorganization).	true
start_block	No	Starting block height (inclusive).	129870
end_block	No	Ending block height (inclusive).	130000
start_time	No	Starting time in ISO 8601 (inclusive).	2022-04-01T00:00:00.000Z
end_time	No	Ending time in ISO 8601 (inclusive).	2022-05-01T00:00:00.000Z
sort	No	Returns the data in ascending (asc) or descending (desc) order. Default: desc.	asc
page_size	No	Number of snapshots to return data for. (default: 1000, min: 1, max: 1000). See Pagination	100

Fields

Field	Description	Example
blockchain	The blockchain on which the transaction happened.	ethereum
block_number	The height of the block.	129876
pool_name	Name of the pool as it is written on the blockchain.	3pool
pool_address	Address of the contract of the pool.	0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7
exchange	Code of the DEX.	curv
amounts	Snapshot of the liquidity pool's tokens.	See example
datetime	Timestamp at which the interval begins. In milliseconds.	1650441900000

Request examples

cURL

curl --compressed -H 'Accept: application/json' -H 'X-Api-Key: KAIKO_API_KEY' \
  'https://us.market-api.kaiko.io/v2/data/liquidity.v1/snapshots?pool_address=0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7&start_block=129870&end_block=129880'

Python

import http.client
import json

# Enter your Kaiko API Key
api_key = "KAIKO_API_KEY"
api_host = "us.market-api.kaiko.io"
api_base_endpoint = "/v2/data/liquidity.v1/snapshots"

# Start of mandatory parameter configuration
mandatory_params = {
    "pool_address": "0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7"
}
# End of mandatory parameter configuration

# Start of optional parameter configuration
optional_params = {
    "start_block": "129870",
    "end_block": "129880"
}
# End of optional parameter configuration
conn = http.client.HTTPSConnection(api_host)
headers = {
    "X-Api-Key": api_key,
    "Accept": "application/json"
}

all_params = {**mandatory_params, **optional_params}

url_params = []
for param, value in all_params.items():
    url_params.append(f"{param}={value}")
url_params = '&'.join(url_params)

# Pagination for next pages
all_data = []
next_url = f"{api_base_endpoint}?{url_params}"
while next_url:
    conn.request("GET", next_url, headers=headers)
    response = conn.getresponse()
    data = json.loads(response.read().decode("utf-8"))
    all_data.extend(data.get("data", []))
    print(f"Fetched {len(data.get('data', []))} datapoints. Total: {len(all_data)}")
    next_url = data.get("next_url", "").replace("https://us.market-api.kaiko.io", "")
    if not next_url:
        break
conn.close()
print(f" datapoints fetched: {(all_data)}")

Response example

{
    "query": {
        "blockchain": "ethereum",
        "protocol": "*",
        "pool_address": "0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7",
        "start_block": "129870",
        "end_block": "129880",
        "start_time": "*",
        "end_time": "*",
        "sort": "descending",
        "page_size": "100",
        "live": "false"
    },
    "time": "2024-09-27T13:54:13.515Z",
    "timestamp": 1727445253,
    "data": [
        {
            "block_number": "129880",
            "pool_name": "",
            "pool_address": "0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7",
            "exchange": "curv",
            "price": 0,
            "amounts": [],
            "datetime": -62135596800,
            "blockchain": "ethereum"
        },
        {
            "block_number": "129879",
            "pool_name": "",
            "pool_address": "0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7",
            "exchange": "curv",
            "price": 0,
            "amounts": [],
            "datetime": -62135596800,
            "blockchain": "ethereum"
        },
        {
            "block_number": "129878",
            "pool_name": "",
            "pool_address": "0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7",
            "exchange": "curv",
            "price": 0,
            "amounts": [],
            "datetime": -62135596800,
            "blockchain": "ethereum"
        },
        {
            "block_number": "129877",
            "pool_name": "",
            "pool_address": "0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7",
            "exchange": "curv",
            "price": 0,
            "amounts": [],
            "datetime": -62135596800,
            "blockchain": "ethereum"
        },
        {
            "block_number": "129876",
            "pool_name": "",
            "pool_address": "0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7",
            "exchange": "curv",
            "price": 0,
            "amounts": [],
            "datetime": -62135596800,
            "blockchain": "ethereum"
        },
        {
            "block_number": "129875",
            "pool_name": "",
            "pool_address": "0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7",
            "exchange": "curv",
            "price": 0,
            "amounts": [],
            "datetime": -62135596800,
            "blockchain": "ethereum"
        },
        {
            "block_number": "129874",
            "pool_name": "",
            "pool_address": "0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7",
            "exchange": "curv",
            "price": 0,
            "amounts": [],
            "datetime": -62135596800,
            "blockchain": "ethereum"
        },
        {
            "block_number": "129873",
            "pool_name": "",
            "pool_address": "0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7",
            "exchange": "curv",
            "price": 0,
            "amounts": [],
            "datetime": -62135596800,
            "blockchain": "ethereum"
        },
        {
            "block_number": "129872",
            "pool_name": "",
            "pool_address": "0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7",
            "exchange": "curv",
            "price": 0,
            "amounts": [],
            "datetime": -62135596800,
            "blockchain": "ethereum"
        },
        {
            "block_number": "129871",
            "pool_name": "",
            "pool_address": "0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7",
            "exchange": "curv",
            "price": 0,
            "amounts": [],
            "datetime": -62135596800,
            "blockchain": "ethereum"
        }
    ]
}