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

ParameterRequiredDescriptionExample

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

FieldDescriptionExample

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 --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'

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"
        }
    ]
}

Last updated