Портал розробників
Тема

Get Native Token Holder Addresses#

Get the native token position ranking of a chain, and only return the address with a balance of top 10000.

Request Path#

GET
https://web3.okx.com/api/v5/xlayer/address/native-token-position-list

Request Parameters#

ParameterTypeRequiredDescription
chainShortNameStringYesThe abbreviated name of the blockchain network, e.g, XLAYER
pageStringNoPage number
limitStringNoNumber of results per page, default is 20, maximum is 100.

Response Parameters#

ParameterTypeDescription
pageStringPage number.
limitStringNumber of results per page; default is a minimum of 20 and a maximum of 100.
totalPageStringTotal number of pages.
positionListArrayPosition list
> rankStringRank of the token balance
> symbolStringSymbol of the token held
> addressStringHolder address
> amountStringHolding amount

Request Example#

shell
curl --location --request GET 'https://web3.okx.com/api/v5/xlayer/address/native-token-position-list?chainShortName=xlayer&limit=3' \
--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": [
        {
            "page": "1",
            "limit": "3",
            "totalPage": "3334",
            "positionList": [
                {
                    "rank": "1",
                    "symbol": "OKB",
                    "holderAddress": "0x2a3dd3eb832af982ec71669e178424b10dca2ede",
                    "amount": "340282366920938000000"
                },
                {
                    "rank": "2",
                    "symbol": "OKB",
                    "holderAddress": "0x611f7bf868a6212f871e89f7e44684045ddfb09d",
                    "amount": "130934.4995103933"
                },
                {
                    "rank": "3",
                    "symbol": "OKB",
                    "holderAddress": "0xa1d2c4533d867ce4623681f68df84d9cad73cb6b",
                    "amount": "43340.318559400665"
                }
            ]
        }
    ]
}