Top Token Holder#
Return Top 20 holder addresses and specific token holding amount.
Request URL#
GET https://web3.okx.com/api/v5/dex/market/token/holder
Request Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| chainIndex | String | Yes | Unique identifier for the chain. e.g., 1: Ethereum. See more here. |
| tokenContractAddress | String | Yes | Token contract address (e.g., 0x382bb369d343125bfb2117af9c149795c6c65c50) |
Response Parameters#
| Parameter | Type | Description |
|---|---|---|
| holdAmount | String | Number of tokens the holder holds on the specific token |
| holderWalletAddress | String | Wallet address of the token holder |
Request Example#
shell
curl --location --request GET 'https://web3.okx.com/api/v5/dex/market/token/holder?chainIndex=501&tokenContractAddress=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v' \
--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": [
{
"holdAmount": "570747950.108575",
"holderWalletAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"
},
{
"holdAmount": "500000000.001",
"holderWalletAddress": "3gd3dqgtJ4jWfBfLYTX67DALFetjc5iS72sCgRhCkW2u"
},
{
"holdAmount": "403111293.236032",
"holderWalletAddress": "AVzP2GeRmqGphJsMxWoqjpUifPpCret7LqWhD8NWQK49"
},
{
"holdAmount": "272206237.244708",
"holderWalletAddress": "7VHUFJHWu2CuExkJcJrzhQPJ2oygupTWkL2A2For4BmE"
},
{
"holdAmount": "259027606.450607",
"holderWalletAddress": "5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9"
},
{
"holdAmount": "252904995.765205",
"holderWalletAddress": "9d9mb8kooFfaD3SctgZtkxQypkshx6ezhbKio89ixyy2"
},
{
"holdAmount": "113506938.878224",
"holderWalletAddress": "FWznbcNXWQuHTawe9RxvQ2LdCENssh12dsznf4RiouN5"
},
{
"holdAmount": "101985136.043764",
"holderWalletAddress": "DBD8hAwLDRQkTsu6EqviaYNGKPnsAMmQonxf7AH8ZcFY"
},
{
"holdAmount": "73752706.890644",
"holderWalletAddress": "6FEVkH17P9y8Q9aCkDdPcMDjvj7SVxrTETaYEm8f51Jy"
},
{
"holdAmount": "72838497.992745",
"holderWalletAddress": "3csuXZKah5rgpb8RiwX9XfjrMxcp3u1K9mBdCwL51spj"
},
{
"holdAmount": "66079266.10245",
"holderWalletAddress": "B9spsrMK6pJicYtukaZzDyzsUQLgc3jbx5gHVwdDxb6y"
},
{
"holdAmount": "63824158.64382",
"holderWalletAddress": "7MNeJP9gi5kBY1DVzJA1kzdeCr6oscXEZW51XMnmByC7"
},
{
"holdAmount": "63539584.430483",
"holderWalletAddress": "AC5RDfQFmDS1deWZos921JfqscXdByf8BKHs5ACWjtW2"
},
{
"holdAmount": "55351694.338679",
"holderWalletAddress": "6iyaZw4aLJhmh2WXydrDw4poX1uzeu2UDfSatCwqmzPA"
},
{
"holdAmount": "51465340.60226",
"holderWalletAddress": "F6ZjiBm1WgVXzez5vxHeBDgaVPQRfLyFb7GFwXvyZVxD"
},
{
"holdAmount": "50916839.714253",
"holderWalletAddress": "9un5wqE3q4oCjyrDkwsdD48KteCJitQX5978Vh7KKxHo"
},
{
"holdAmount": "49730509.851315",
"holderWalletAddress": "4kWwg9hQri1aFVqjxayDVmjmYtjXjrf1h5TpfvvAk5Sm"
},
{
"holdAmount": "44593888.562",
"holderWalletAddress": "61yKS9bjxWdqNgAHt439DfoNfwK3uKPAJGWAsFkC5M4C"
},
{
"holdAmount": "39477953.030487",
"holderWalletAddress": "F5aW6AUHn74rwpU6wS6PT77FrXWCfKcT7jX26fpbE635"
},
{
"holdAmount": "36288729.399797",
"holderWalletAddress": "AS5MV3ear4NZPMWXbCsEz3AdbCaXEnq4ChdaWsvLgkcM"
}
],
"msg": ""
}