Portail dév.
Thème

Get Holder Address Statistics#

Query address statistics for a specific chain, including the number of holder addresses, total addresses, contract addresses, external addresses, and active addresses, each with its 24-hour change.

Supported chains: see Get Chain Info API Supported Chains (apiName: address).

Request URL#

GET
https://web3.okx.com/api/v6/explorer/info/address

Request Parameters#

ParameterTypeRequiredDescription
chainIndexStringYesUnique identifier of the chain, e.g., 1 for ETH, 0 for BTC. See Get Chain Info API Supported Chains for supported values.

Response Parameters#

ParameterTypeDescription
chainIndexStringUnique identifier of the chain.
symbolStringNative token of the chain.
validAddressCountStringNumber of addresses holding the chain's native token.
newAddressCount24hStringNumber of new holder addresses in the last 24 hours.
totalAddressesStringTotal number of addresses on the chain.
newTotalAddresses24hStringIncrease or decrease in total addresses over the last 24 hours.
contractAddressesStringTotal number of contract addresses on the chain.
newContractAddresses24hStringIncrease or decrease in contract addresses over the last 24 hours.
externalAddressesStringNumber of external addresses.
newExternalAddresses24hStringIncrease or decrease in external addresses over the last 24 hours.
activeAddressesStringNumber of active addresses.
newActiveAddressesStringIncrease or decrease in active addresses over the last 24 hours.

Request Example#

shell
curl --location --request GET 'https://web3.okx.com/api/v6/explorer/info/address?chainIndex=1' \
--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": [
        {
            "chainIndex": "1",
            "symbol": "ETH",
            "validAddressCount": "141234567",
            "newAddressCount24h": "98765",
            "totalAddresses": "331234567",
            "newTotalAddresses24h": "120345",
            "contractAddresses": "68123456",
            "newContractAddresses24h": "23456",
            "externalAddresses": "263111111",
            "newExternalAddresses24h": "96889",
            "activeAddresses": "512345",
            "newActiveAddresses": "-2345"
        }
    ]
}