Pools

What are pools and how do we index them ?

In the context of decentralized finance (DeFi) liquidity pools are pools of assets that are used to provide liquidity for decentralized exchanges (DEXs). These pools are typically created and managed by community members, and allow users to trade assets on a DEX without the need for a centralized intermediary.

Most pools hold two tokens. For example the WETH-USDC pool on uniswap allows users to trade ETH against USDC. You can get more informations on tokens in the corresponding section

Every swap that we record comes with data such as the pool on which it was traded and various properties such as the amounts of tokens traded, the sender etc. Every day, we analyze recent swaps in our database and insert new pools/tokens if we have swaps on a pool that is currently not indexed in our database.

Response Format

Format

Field	Type	Description
pool_name	string	Human-readable pool name (not unique)
address	string	Pool network id
token0	string	address of the first token in the pool
token1	string	address of the second token in the pool
exchange	string	DEX factory address from which the pool was deployed
exchange_name	string	DEX name
create_block_number	number	Block number at which the pool was created
create_time	number	The datetime at which the pool was created, in ISO8601 format

Example Response:

JSON

{
    "statusCode": 200,
    "status": true,
    "data": [
        {
            "pool_name": "WETH-PHD",
            "address": "0x29a03d2cf429ffe374cf42931aad746c3463ce7e",
            "network": 1,
            "token0": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "token1": "0xee47be06113f399a70a74593b087d9115a0dd517",
            "create_block_number": 15620976,
            "create_time": "2022-09-27T00:00:00.000Z",
            "exchange": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f",
            "exchange_name": "uniswapv2"
        },
       ...
       ],
}