Get tokens#

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

Request address#

GET https://www.okx.com/api/v5/dex/aggregator/all-tokens

Request param#

Parameter	Type	Required	Description
chainId	String	Yes	Chain ID (e.g., `1` for Ethereum. See Chain IDs)

Response param#

Parameter	Type	The precision of tokens
decimals	String	The precision of tokens (e.g., `18`)
tokenContractAddress	String	Token contract address (e.g., `0x382bb369d343125bfb2117af9c149795c6c65c50`)
tokenLogoUrl	String	Token logo (e.g., `https://static.okx.com/cdn/wallet/logo/USDT-991ffed9-e495-4d1b-80c2-a4c5f96ce22d.png`)
tokenName	String	Token full name (e.g., `Tether`)
tokenSymbol	String	Token symbol (e.g., `USDT`)

Request example#

shell

curl --location --request GET 'https://www.okx.com/api/v5/dex/aggregator/all-tokens?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": [
    {
      "decimals": "18",
      "tokenContractAddress": "0x382bb369d343125bfb2117af9c149795c6c65c50",
      "tokenLogoUrl": "https://static.okx.com/cdn/wallet/logo/USDT-991ffed9-e495-4d1b-80c2-a4c5f96ce22d.png",
      "tokenName": "Tether",
      "tokenSymbol": "USDT"
    },
    {
      "decimals": "18",
      "tokenContractAddress": "0xc946daf81b08146b1c7a8da2a851ddf2b3eaaf85",
      "tokenLogoUrl": "https://static.okx.com/cdn/explorer/okexchain/exchain_usdc.png",
      "tokenName": "USD Coin",
      "tokenSymbol": "USDC"
    },
    {
      "decimals": "18",
      "tokenContractAddress": "0xdf54b6c6195ea4d948d03bfd818d365cf175cfc2",
      "tokenLogoUrl": "https://static.okx.com/cdn/wallet/logo/okb.png",
      "tokenName": "OKB",
      "tokenSymbol": "OKB"
    },
    {
      "decimals": "18",
      "tokenContractAddress": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
      "tokenLogoUrl": "https://static.okx.com/cdn/wallet/logo/okt.png",
      "tokenName": "OKTC",
      "tokenSymbol": "OKT"
    },
    {
      "decimals": "18",
      "tokenContractAddress": "0x218c3c3d49d0e7b37aff0d8bb079de36ae61a4c0",
      "tokenLogoUrl": "https://static.okx.com/cdn/wallet/logo/BNB-20220308.png",
      "tokenName": "Binance Coin",
      "tokenSymbol": "BNB"
    },
    {
      "decimals": "18",
      "tokenContractAddress": "0x332730a4f6e03d9c55829435f10360e13cfa41ff",
      "tokenLogoUrl": "https://static.okx.com/cdn/wallet/logo/BUSD-20220308.png",
      "tokenName": "Binance USD",
      "tokenSymbol": "BUSD"
    },
    {
      "decimals": "18",
      "tokenContractAddress": "0xdcac52e001f5bd413aa6ea83956438f29098166b",
      "tokenLogoUrl": "https://static.okx.com/cdn/wallet/logo/eth_usdk.png",
      "tokenName": "USDK",
      "tokenSymbol": "USDK"
    }
  ],
  "msg": ""
}