代币持有者信息#
支持查看前 100 名持有者的地址及对应的持仓信息
请求路径#
GET https://web3.okx.com/api/v6/dex/market/token/holder
请求参数#
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| chainIndex | String | 是 | 链的唯一标识符。例如：1：以太坊。 |
| tokenContractAddress | String | 是 | 代币合约地址（例如 0x382bb369d343125bfb2117af9c149795c6c65c50） |
| tagFilter | String | 否 | 默认：不输入，返回前 100 名持币地址的数据，按总收益倒序排列。 输入 1：返回标记为 KOL 的地址 输入 2：返回标记为开发者的代币地址 输入 3：返回标记为聪明钱的地址 输入 4：返回标记为巨鲸的持仓地址 输入 5：返回标记为新钱包的地址 输入 6：返回标记为可疑的持仓地址 输入 7：返回标记为狙击手的持仓地址 输入 8：返回标记为疑似钓鱼的地址 输入 9：返回标记为 Bundle 的地址 |
| cursor | String | 否 | 分页游标，传入上一次请求返回的 cursor 值 |
| limit | String | 否 | 每页返回数量，最大 100 |
返回参数#
| 字段 | 类型 | 描述 |
|---|---|---|
| cursor | String | 分页游标 |
| holdPercent | String | 持仓占比 |
| nativeTokenBalance | String | 主网币余额 |
| boughtAmount | String | 累计买入数量 |
| avgBuyPrice | String | 平均买入价格 |
| totalSellAmount | String | 累计卖出数量 |
| avgSellPrice | String | 平均卖出价格 |
| totalPnlUsd | String | 总盈亏 |
| realizedPnlUsd | String | 已实现盈亏 |
| unrealizedPnlUsd | String | 未实现盈亏 |
| fundingSource | String | 资金来源 |
请求示例#
Shell
curl --location --request GET 'https://web3.okx.com/api/v6/dex/market/token/holder?chainIndex=501&tokenContractAddress=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&tagFilter=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'
返回示例#
Json
-- 不是深度分页，只支持在内存返回的 最多100条数据中 分页
{
"code": "0",
"data": [
{
"avgBuyPrice": "0",
"avgSellPrice": "0",
"boughtAmount": "0",
"fundingSource": "9k8jWWqfmTTXrc8gmZqYVxSFJhygURvyVRztivJXFTYP",
"holdAmount": "767501192.534284",
"holdPercent": "76.750184380179418200",
"holderWalletAddress": "2RH6rUTPBJ9rUDPpuV9b8z1YL56k1tYU6Uk5ZoaEFFSK",
"nativeTokenBalance": "6.091849989",
"realizedPnlUsd": "0",
"totalPnlUsd": "0.000000000000000000",
"totalSellAmount": "0",
"unrealizedPnlUsd": "0.000000000000000000",
"cursor": "0"
},
{
"avgBuyPrice": "0",
"avgSellPrice": "0",
"boughtAmount": "0",
"fundingSource": "5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9",
"holdAmount": "36715842.016",
"holdPercent": "3.671587317143695100",
"holderWalletAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
"nativeTokenBalance": "13908916.377375046",
"realizedPnlUsd": "0",
"totalPnlUsd": "0.000000000000000000",
"totalSellAmount": "0",
"unrealizedPnlUsd": "0.000000000000000000",
"cursor": "1"
}
],
"msg": ""
}