DEX API

Get liquidity sources#

Get a list of liquidity that are available for swap in the OKX aggregation protocol.

Request address#

GET https://www.okx.com/api/v5/dex/aggregator/get-liquidity

Request param#

ParameterTypeRequiredDescription
chainIdStringYesChain ID (e.g., 1 for Ethereum. See Chain IDs)

Response param#

ParameterTypeThe precision of tokens
idStringThe id of liquidity (e.g., 34)
nameStringThe name of liquidity (e.g., Uniswap V2)

Request example#

shell
curl --location --request GET 'https://www.okx.com/api/v5/dex/aggregator/get-liquidity?chainId=1' \
--header 'OK-ACCESS-PROJECT: 86af********d1bc' \
--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z'

Response example#

200
{
  "code":"0",
  "data":[
      {
        "id":"34",
        "name":"Uniswap V2"
      },
      {
        "id":"29",
        "name":"SushiSwap"
      },
      {
        "id":"47",
        "name":"DeFi Swap"
      },
      {
        "id":"49",
        "name":"Convergence"
      },
      {
        "id":"48",
        "name":"LuaSwap"
      },
      {
        "id":"40",
        "name":"ShibaSwap"
      },
      {
        "id":"30",
        "name":"PancakeSwap"
      },
      {
        "id":"53",
        "name":"Uniswap V3"
      },
      {
        "id":"54",
        "name":"Balancer V1"
      },
      {
        "id":"51",
        "name":"Balancer V2"
      },
      {
        "id":"55",
        "name":"Curve V1"
      },
      {
        "id":"259",
        "name":"Curve"
      },
      {
        "id":"58",
        "name":"Curve V2"
      },
      {
        "id":"52",
        "name":"Bancor"
      },
      {
        "id":"59",
        "name":"Kyber"
      },
      {
        "id":"81",
        "name":"Synapse"
      },
      {
        "id":"83",
        "name":"Wombat"
      },
      {
        "id":"80",
        "name":"DODO"
      },
      {
        "id":"82",
        "name":"Shell"
      },
      {
        "id":"88",
        "name":"DODO V2"
      },
      {
        "id":"91",
        "name":"Smoothy"
      },
      {
        "id":"92",
        "name":"RadioShack"
      },
      {
        "id":"89",
        "name":"FraxSwap"
      },
      {
        "id":"99",
        "name":"OKX DEX"
      },
      {
        "id":"28",
        "name":"HashFlow"
      },
      {
        "id":"101",
        "name":"Swapr"
      },
      {
        "id":"104",
        "name":"Bancor V3"
      },
      {
        "id":"105",
        "name":"PSM"
      },
      {
        "id":"106",
        "name":"Balancer"
      },
      {
        "id":"108",
        "name":"Verse"
      },
      {
        "id":"110",
        "name":"1inch Limit Order"
      },
      {
        "id":"248",
        "name":"OKX Limit Order"
      },
      {
        "id":"132",
        "name":"DefiPlaza"
      },
      {
        "id":"114",
        "name":"Swerve"
      },
      {
        "id":"113",
        "name":"Kyber Elastic"
      },
      {
        "id":"131",
        "name":"StablePlaza"
      },
      {
        "id":"130",
        "name":"0x Limit Order"
      },
      {
        "id":"133",
        "name":"Clipper"
      },
      {
        "id":"134",
        "name":"Lido"
      },
      {
        "id":"135",
        "name":"Nomiswap Stable"
      },
      {
        "id":"136",
        "name":"Solidly"
      },
      {
        "id":"215",
        "name":"Trader Joe V2.1"
      },
      {
        "id":"153",
        "name":"Cafe Swap"
      },
      {
        "id":"141",
        "name":"ELK"
      },
      {
        "id":"102",
        "name":"Unifi"
      },
      {
        "id":"159",
        "name":"LINKSWAP"
      },
      {
        "id":"160",
        "name":"Sake Swap"
      },
      {
        "id":"27",
        "name":"Curve 3CRV"
      },
      {
        "id":"202",
        "name":"Aave V2"
      },
      {
        "id":"230",
        "name":"Aave V3"
      },
      {
        "id":"199",
        "name":"Compound"
      },
      {
        "id":"184",
        "name":"sfrxETH"
      },
      {
        "id":"186",
        "name":"stMatic"
      },
      {
        "id":"200",
        "name":"PancakeSwap V3"
      },
      {
        "id":"203",
        "name":"RocketPool"
      },
      {
        "id":"207",
        "name":"Kronos"
      },
      {
        "id":"204",
        "name":"1inch LP v1.1"
      },
      {
        "id":"210",
        "name":"Curve TNG"
      },
      {
        "id":"214",
        "name":"Mooniswap"
      },
      {
        "id":"213",
        "name":"Integral"
      },
      {
        "id":"218",
        "name":"Maverick V1"
      },
      {
        "id":"226",
        "name":"Curve LLAMMA"
      },
      {
        "id":"234",
        "name":"xSigma"
      },
      {
        "id":"239",
        "name":"Sushiswap V3"
      },
      {
        "id":"262",
        "name":"Solidly V3"
      }
  ],
  "msg":""
}