Get Tokens#
It fetches a list of tokens. This interface returns a list of tokens that belong to major platforms or are deemed significant enough by OKX. However, you can still quote and swap other tokens outside of this list on OKX DEX.
Request URL#
GET https://web3.okx.com/api/v5/dex/aggregator/all-tokens
Request Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| chainIndex | String | No | Unique identifier for the chain. e.g., 1: Ethereum. See more here. |
| chainId | String | No | Unique identifier for the chain. It will be deprecated in the future. |
Response Parameters#
| Parameter | Type | Description |
|---|---|---|
| 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://web3.okx.com/api/v5/dex/aggregator/all-tokens?chainIndex=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": ""
}