Market API

Token Basic Information#

Retrieve the basic token information of the specified token contract address

Request URL#

POST https://web3.okx.com/api/v5/dex/market/token/basic-info

Request Parameters#

ParameterTypeRequiredDescription
chainIndexStringYesUnique identifier for the chain.
e.g., 1: Ethereum.
See more here.
tokenContractAddressStringYesToken contract address (e.g., 0x382bb369d343125bfb2117af9c149795c6c65c50)

Response Parameters#

ParameterTypeDescription
chainIndexStringUnique identifier of the chain. (Such as 1: Ethereum, for more see the list of chainIndex )
tokenNameStringToken name
tokenSymbolStringToken identification
tokenLogoUrlStringToken icon url
decimalStringToken precision
tagListObjectLabel
>communityRecognizedBooleanTrue means it's listed in the Top 10 CEX or is community verifed

Request Example#

shell
curl --location --request POST 'https://web3.okx.com/api/v5/dex/market/token/basic-info' \
--header 'Content-Type: application/json' \
--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' \
--data-raw '[
     {
    "chainIndex": "501",
    "tokenContractAddress": "5mbK36SZ7J19An8jFochhQS4of8g6BwUjbeCSxBSoWdp"
},
{

     "chainIndex": "501",
    "tokenContractAddress": "eL5fUxj2J4CiQsmW85k5FG9DvuQjjUoBHoQBi2Kpump"
    
}
]'

Response Example#

200
{
    "code": "0",
    "data": [
        {
            "chainIndex": "501",
            "decimal": "6",
            "tagList": {
                "communityRecognized": true
            },
            "tokenContractAddress": "5mbK36SZ7J19An8jFochhQS4of8g6BwUjbeCSxBSoWdp",
            "tokenLogoUrl": "https://static.oklink.com/cdn/web3/currency/token/small/501-5mbK36SZ7J19An8jFochhQS4of8g6BwUjbeCSxBSoWdp-106?v=1749146943562",
            "tokenName": "michi",
            "tokenSymbol": "$michi"
        },
        {
            "chainIndex": "501",
            "decimal": "6",
            "tagList": {
                "communityRecognized": true
            },
            "tokenContractAddress": "eL5fUxj2J4CiQsmW85k5FG9DvuQjjUoBHoQBi2Kpump",
            "tokenLogoUrl": "https://static.oklink.com/cdn/web3/currency/token/large/501-eL5fUxj2J4CiQsmW85k5FG9DvuQjjUoBHoQBi2Kpump-108/type=default_90_0?v=1755815305433",
            "tokenName": "Unicorn Fart Dust",
            "tokenSymbol": "UFD"
        }
    ],
    "msg": ""
}