On-Chain pools

You can explore all exchanges, assets, and get codes for them using our instrument explorer. Alternatively, if you want to obtain the data in a more programmatic way, use this endpoint.

What is this endpoint for?

This endpoint retrieves a list of all pools supported by Kaiko. This can help you identify which markets are available when working with our data.

Endpoint

https://reference-data-api.kaiko.io/v1/pools

Parameters

Field	Required?	Description
blockchain	No	Filter on a specific blockchain.
protocol	No	Exchange code. See Exchange codes
tokens	No	The desired asset code. See Asset codes

No parameters supported

Fields

Field	Description
blockchain	The blockchain.
address	The blockchain address of the pool.
name	The name of the pool.
protocol	The protocol code. Ex:usp3,aav3, curv, blc2
type	The pool type.
fee	The fee tier.
tokens	Table of each token in the pool. Some pools have 1 token (lending vaults), some can have up to 8 tokens (Balancer DEX). Format: [{blockchain, address, symbol, decimals}, ]
tickSpacing	For concentrated liquidity pools.
weights	For Balancer weighted pools.

Request example

cURL

curl --compressed -H 'Accept: application/json' 'https://reference-data-api.kaiko.io/v1/pools'

Response example

JSON

{
    "result": "success",
    "count": 1537,
    "data":
    [
        {
            "blockchain": "bsc",
            "address": "0x0004222c2075e9a1291e41f1ca4c8d32141db501",
            "name": "MBOX-WBNB-0.003",
            "protocol": "pks3",
            "type": "liquidity_pool",
            "fee": "0.0025",
            "tokens":
            [
                {
                    "blockchain": "bsc",
                    "address": "0x3203c9e46ca618c8c1ce5dc67e7e9d75f5da2377",
                    "symbol": "mbox",
                    "decimals": "18"
                },
                {
                    "blockchain": "bsc",
                    "address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c",
                    "symbol": "wbnb",
                    "decimals": "18"
                }
            ],
            "tickSpacing": "50"
        },
        /**********/
    ]
}