查询主链币持仓地址列表#
获取链的主链币持仓地址列表，仅返回余额Top 10000的地址信息。
请求路径#
GET
https://web3.okx.com/api/v5/xlayer/address/native-token-position-list请求参数#
| 参数名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| chainShortName | String | 是 | 公链缩写符号，例如 XLAYER |
| page | String | 否 | 页码 |
| limit | String | 否 | 每页返回的数据条数，默认20条，最多100条 |
响应参数#
| 参数名 | 类型 | 描述 |
|---|---|---|
| page | String | 页码 |
| limit | String | 每页返回的数据条数，默认最小20条，最多100条 |
| totalPage | String | 总共的页数 |
| positionList | Array | 持仓列表 |
| > rank | String | 地址余额排名 |
| > symbol | String | 持仓币种 |
| > address | String | 持仓地址 |
| > amount | String | 持仓数量 |
请求示例#
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'
响应示例#
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"
}
]
}
]
}