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

ParameterRequiredDescription

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

FieldDescription

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 --compressed -H 'Accept: application/json' 'https://reference-data-api.kaiko.io/v1/pools'

Response example

{
  "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"}
      ]
    },
    /* ... */
  ]
}

Last updated