代币 API

代币盈利地址信息#

支持查看前 100 名盈利地址及对应的地址信息

请求路径#

GET https://web3.okx.com/api/v6/dex/market/token/top-trader

请求参数#

返回前100个盈利地址

参数类型必填描述
chainIndexString链的唯一标识。例如:1:Ethereum。
tokenContractAddressString代币合约地址(例如:0x382bb369d343125bfb2117af9c149795c6c65c50)
tagFilterString默认:不输入,返回前100盈利地址数据,按照已实现收益倒序排列。
输入 1:返回标签为KOL的持币地址
输入 2:返回标签为开发者的持币地址
输入 3:返回标签为聪明钱的持币地址
输入 4:返回标签为巨鲸的持币地址
输入 5:返回标签为新钱包的持币地址
输入 6:返回标签为老鼠仓的持币地址
输入 7:返回标签为狙击手的持币地址
输入 8:返回标签为疑似钓鱼的持币地址
输入 9:返回标签为捆绑交易者的持币地址

响应参数#

字段名类型说明
holderWalletAddressString持币地址
holdAmountString持币数量
holdPercentString持币百分比
nativeTokenBalanceString主网币余额
boughtAmountString总买入数量
avgBuyPriceString买入均价
soldAmountString总卖出数量
avgSellPriceString卖出均价
totalPnlUsdString总收益
realizedPnlUsdString已实现盈亏
unrealizedPnlUsdString未实现盈亏
fundingSourceString资金来源

请求示例#

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.006257412387131871",
            "avgSellPrice": "0.03955884977123357",
            "boughtAmount": "0",
            "fundingSource": "3QKYDVsRahmjCQEYVdaAAFuqeiDR54BYBxkbcXErWPoa",
            "holdAmount": "0",
            "holdPercent": "0.000000000000000000",
            "holderWalletAddress": "BSZ5Qn9DEZZhXvTGvaQhobgXCCZPJDSkgB9dZnAhgAPd",
            "nativeTokenBalance": "0",
            "realizedPnlUsd": "973116.826246666274017495452279",
            "soldAmount": "0",
            "totalPnlUsd": "973116.826246666274017495452279",
            "unrealizedPnlUsd": "0.000000000000000000"
        },
        {
            "avgBuyPrice": "0.000290600103990537",
            "avgSellPrice": "0.023438110254671877",
            "boughtAmount": "0",
            "fundingSource": "BcHgs6pJhczyGzPEpFaGQnfB7vFoSdjzyG2h1wcUnp8X",
            "holdAmount": "0",
            "holdPercent": "0.000000000000000000",
            "holderWalletAddress": "9UWZFoiCHeYRLmzmDJhdMrP7wgrTw7DMSpPiT2eHgJHe",
            "nativeTokenBalance": "0",
            "realizedPnlUsd": "539485.070634565078258202715521",
            "soldAmount": "0",
            "totalPnlUsd": "539485.070634565078258202715521",
            "unrealizedPnlUsd": "0.000000000000000000"
        }
    ],
    "msg": ""
}