Portail dév.
Thème

Get Address Information#

Get the information of an address, you can get the detail information such as balance, token balance, number of contract calls, contract corresponding tokens.

Request Path#

GET
https://web3.okx.com/api/v5/xlayer/address/information-evm

Request Parameters#

ParameterTypeRequiredDescription
chainShortNameStringYesThe abbreviated name of the blockchain network, e.g, XLAYER
addressStringYesAddress

Response Parameters#

ParameterTypeDescription
addressStringOrdinary address
balanceStringNative token balance of the address
balanceSymbolStringSymbol of native token
transactionCountStringThe transaction amount of the address
firstTransactionTimeStringThe time when the first transaction occurred of this address
lastTransactionTimeStringThe last transaction time of this address
contractAddressBolWhether it is the contract validator address
createContractAddressStringContract creator address
createContractTransactionHashStringThe transaction hash that created the smart contract
contractCorrespondingTokenStringCorresponding token
contractCallsStringThe number of times the contract was called in the last 30 days. External and internal transactions are counted.
contractCallingAddressesStringThe number od addresses that called the contract in the last 30 days.

Request Example#

shell
curl --location --request GET 'https://web3.okx.com/api/v5/xlayer/address/information-evm?address=0x1e4a5963abfd975d8c9021ce480b42188849d41d&chainShortName=xlayer' \
--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#

json
{
    "code": "0",
    "msg": "",
    "data": [
        {
            "address": "0x1e4a5963abfd975d8c9021ce480b42188849d41d",
            "balance": "0",
            "balanceSymbol": "OKB",
            "transactionCount": "608262",
            "firstTransactionTime": "",
            "lastTransactionTime": "1755569321000",
            "contractAddress": true,
            "createContractAddress": "0x2a3dd3eb832af982ec71669e178424b10dca2ede",
            "createContractTransactionHash": "0x1c17ce8a0afdd2ca0ff546ef3076f1f6ebb867072db6a27029a2a4ab6764825b",
            "contractCorrespondingToken": "USDT",
            "contractCalls": "328353",
            "contractCallingAddresses": "27164"
        }
    ]
}