DEX API
Get the list of tokens supported by the cross-chain bridges

Get the list of tokens supported by the cross-chain bridges#

If the source-chain token and the destination-chain token select the same symbol pair in this token list, they can be traded directly across the bridge, without making a source-chain swap or a destination-chain swap. If the destination-chain token is in this token list, while any token can be the source-chain token, the cross-chain path will first perform the source-chain swap, and then perform the cross-chain bridge transaction, without making a source-chain swap.

Note
The public DEX API is deprecated. To continue using the API service, please visit the Developer Portal to apply for an API key.

Request address#

GET https://www.okx.com/api/v5/dex/cross-chain/supported/tokens

Request param#

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

Response param#

ParameterTypeDescription
chainIdStringChain ID (e.g., 1 for Ethereum. See Chain IDs)
decimalsIntegerThe precision of tokens (e.g., 18)
tokenContractAddressStringToken contract address (e.g., 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2)
tokenNameStringToken name (e.g., USDC)
tokenSymbolStringToken symbol (e.g., 6)

Request example#

shell
curl --location --request GET 'https://www.okx.com/api/v5/dex/cross-chain/supported/tokens' \
--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": [
      {
        "chainId": 1,
        "decimals": 6,
        "tokenContractAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "tokenName": "USDC",
        "tokenSymbol": "USDC"
      },
      {
        "chainId": 1,
        "decimals": 18,
        "tokenContractAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "tokenName": "Wrapped Ether",
        "tokenSymbol": "WETH"
      }
  ],
  "msg": ""
}