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 supported pools. The caracteristics of each pool differs depending on the protocol.

Endpoint

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

Parameters

Parameter	Required	Description
address	No	The pool's contract address.
protocol	No	The pool's protocol.
type	No	The pool's type. ex: Curve meta pool, Curve base pool, etc.
fee	No	The trading fees on this pool.
tokens	No	Filter on one or several tokens in the pool.
underlying_tokens	No	Filter on one or several tokens in the pool. Specific to Curve.

Fields

Field	Description
address	The pool's contract address.
name	The pool's name as it is specified on-chain.
protocol	The pool's protocol. ex:usp2,usp3, curv, blcr
type	The pool's type. ex: Curve meta pool, Curve base pool, etc.
fee	The trading fees on this pool.
tokens	The pool's tokens.
underlyingTokens	The underlying tokens in the pool. Specific to Curve.
tickSpacing	The pool's tick spacing. Specific to Uniswap v3.
weights	The weights of the different tokens in the pool. Specific to Balancer.

Request example

cURL

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

Response example

JSON

{
  "result":"success",
  "data":[
    {"address":"0x52ea46506b9cc5ef470c5bf89f17dc28bb35d85c",
      "name":"usdt",
      "protocol":"curv",
      "type":"base pool",
      "fee":"0.0004",
      "tokens":[
        {"address":"0x5d3a536e4d6dbd6114cc1ead35777bab948e3643","symbol":"cDAI","decimals":"8"},
        {"address":"0x39aa39c021dfbae8fac545936693ac917d5e7563","symbol":"cUSDC","decimals":"8"},
        {"address":"0xdac17f958d2ee523a2206206994597c13d831ec7","symbol":"USDT","decimals":"6"}
      ],
      "underlyingTokens":[
        {"address":"0x6b175474e89094c44da98b954eedeac495271d0f","symbol":"DAI","decimals":"18"},
        {"address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","symbol":"USDC","decimals":"6"},
        {"address":"0xdac17f958d2ee523a2206206994597c13d831ec7","symbol":"USDT","decimals":"6"}
      ]
    },
    /* ... */
  ]
}