代币持有人信息#
支持查看前 100 名持有人地址及对应的持仓信息
Token Holder Information#
Support viewing the addresses and corresponding position information of the top 100 holders
请求路径 / Request Path#
GET https://web3.okx.com/api/v6/dex/market/token/holder
请求参数 / Request Parameters#
| 参数 / Parameter | 类型 / Type | 必填 / Required | 描述 / Description |
|---|---|---|---|
| chainIndex | String | 是 / Yes | 链的唯一标识。例如：1：Ethereum。Unique identifier of the chain. For example: 1: Ethereum. |
| tokenContractAddress | String | 是 / Yes | 代币合约地址（例如：0x382bb369d343125bfb2117af9c149795c6c65c50） Token contract address (e.g. 0x382bb369d343125bfb2117af9c149795c6c65c50) |
| tagFilter | String | 否 / No | 默认：不输入，返回前100持币地址数据，按照总收益倒序排列。 输入 1：返回标签为KOL的持币地址 输入 2：返回标签为开发者的持币地址 输入 3：返回标签为聪明钱的持币地址 输入 4：返回标签为巨鲸的持币地址 输入 5：返回标签为新钱包的持币地址 输入 6：返回标签为老鼠仓的持币地址 输入 7：返回标签为狙击手的持币地址 输入 8：返回标签为疑似钓鱼的持币地址 输入 9：返回标签为捆绑交易者的持币地址 Default: No input, return the address data of the first 100 holding coin addresses, arranged in reverse order according to the total income. Enter 1: Return the address labeled KOL Enter 2: Return the token address labeled Developer Enter 3: Return the address labeled Smart Money Enter 4: Return the holding address labeled as Whale Enter 5: Return the address labeled New Wallet Enter 6: Return the holding address labeled Suspicious Enter 7: Return the holding address labeled Sniper Enter 8: Return the address labeled as suspected phishing Enter 9: Return the address labeled as Bundle |
响应参数 / Response Parameters#
| 字段名 / Field | 类型 / Type | 说明 / Description |
|---|---|---|
| holdPercent | String | 持币百分比 / Percentage of holdings |
| nativeTokenBalance | String | 主网币余额 / Mainnet currency balance |
| boughtAmount | String | 总买入数量 / Total Buy Quantity |
| avgBuyPrice | String | 买入均价 / Average buying price |
| totalSellAmount | String | 总卖出数量 / Total sold quantity |
| avgSellPrice | String | 卖出均价 / Average selling price |
| totalPnlUsd | String | 总收益 / Total profit and loss |
| realizedPnlUsd | String | 已实现盈亏 / Realized profit and loss |
| unrealizedPnlUsd | String | 未实现盈亏 / Unrealized profit and loss |
| fundingSource | String | 资金来源 / Sources of funding |
请求示例 / Request Example#
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'
响应示例 / Response Example#
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": ""
}