代币盈利地址信息#
支持查看前 100 名盈利地址及对应的地址信息
请求路径#
GET https://web3.okx.com/api/v6/dex/market/token/top-trader
请求参数#
返回前100个盈利地址
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| chainIndex | String | 是 | 链的唯一标识。例如：1：Ethereum。 |
| tokenContractAddress | String | 是 | 代币合约地址（例如：0x382bb369d343125bfb2117af9c149795c6c65c50） |
| tagFilter | String | 否 | 默认：不输入，返回前100盈利地址数据，按照已实现收益倒序排列。 输入 1：返回标签为KOL的持币地址 输入 2：返回标签为开发者的持币地址 输入 3：返回标签为聪明钱的持币地址 输入 4：返回标签为巨鲸的持币地址 输入 5：返回标签为新钱包的持币地址 输入 6：返回标签为老鼠仓的持币地址 输入 7：返回标签为狙击手的持币地址 输入 8：返回标签为疑似钓鱼的持币地址 输入 9：返回标签为捆绑交易者的持币地址 |
| cursor | String | 否 | 分页游标，传入上一次请求返回的 cursor 值 |
| limit | String | 否 | 每页返回数量，最大 100 |
响应参数#
| 字段名 | 类型 | 说明 |
|---|---|---|
| holderWalletAddress | String | 持币地址 |
| cursor | String | 分页游标 |
| holdAmount | String | 持币数量 |
| holdPercent | String | 持币百分比 |
| nativeTokenBalance | String | 主网币余额 |
| boughtAmount | String | 总买入数量 |
| avgBuyPrice | String | 买入均价 |
| soldAmount | 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/top-trader?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.000061961311739113",
"avgSellPrice": "0.000122073405687202",
"boughtAmount": "48443482.085545000000000000",
"cursor": "0",
"fundingSource": "AC5RDfQFmDS1deWZos921JfqscXdByf8BKHs5ACWjtW2",
"holdAmount": "0",
"holdPercent": "0.000000000000000000",
"holderWalletAddress": "GHPyCYecXh398J72qi8nx9Sdaq8PiUJmLoL2q2yLwTY9",
"nativeTokenBalance": "0.024254276",
"realizedPnlUsd": "2912.039146298874538842343358",
"soldAmount": "41626711.761828000000000000",
"totalPnlUsd": "2912.039146298874538842343358",
"unrealizedPnlUsd": "0.000000000000000000"
},
{
"avgBuyPrice": "0.000045836227988662",
"avgSellPrice": "0.000117400306217832",
"boughtAmount": "29120882.898397000000000000",
"cursor": "1",
"fundingSource": "FLipG5QHjZe1H12f6rr5LCnrmqjhwuBTBp78GwzxnwkR",
"holdAmount": "0",
"holdPercent": "0.000000000000000000",
"holderWalletAddress": "HYSq1KBAvqWpEv1pCbV31muKM1za5A1WSHGdiVLUoNhb",
"nativeTokenBalance": "37.572873625",
"realizedPnlUsd": "2084.009141843422246184643326",
"soldAmount": "29120882.898397000000000000",
"totalPnlUsd": "2084.009141843422246184643326",
"unrealizedPnlUsd": "0.000000000000000000"
}
],
"msg": ""
}