代币持有者信息#
支持查看前 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 的地址 |
返回参数#
| 字段 | 类型 | 描述 |
|---|---|---|
| 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
{
"code": "0",
"data": [
{
"avgBuyPrice": "0",
"avgSellPrice": "0",
"boughtAmount": "0",
"fundingSource": "FE86HYyFkqRVk2fNy6TUatrpoekQmcC2Pa8iybc7wZzU",
"holdAmount": "96080378.806242",
"holdPercent": "9.608239644552870900",
"holderWalletAddress": "9SLPTL41SPsYkgdsMzdfJsxymEANKr5bYoBsQzJyKpKS",
"nativeTokenBalance": "215136.210273336",
"realizedPnlUsd": "0",
"totalPnlUsd": "0.00000000000000000",
"totalSellAmount": "0",
"unrealizedPnlUsd": "0.00000000000000000"
},
{
"avgBuyPrice": "",
"avgSellPrice": "",
"boughtAmount": "",
"fundingSource": "APhyMCpYjQ9RdEBn8cs4ifyBXjxAS5JtM3wYpWMJjsY5",
"holdAmount": "48368067.930867",
"holdPercent": "4.836908363579335500",
"holderWalletAddress": "u6PJ8DtQuPFnfmwHbGFULQ4u4EgjDiyYKjVEsynXq2w",
"nativeTokenBalance": "63212.857153485",
"realizedPnlUsd": "",
"totalPnlUsd": "",
"totalSellAmount": "",
"unrealizedPnlUsd": ""
}
],
"msg": ""
}