Token Profit Address Information#

Support viewing the top 100 profitable addresses and corresponding address information

Request Path#

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

Request Parameters#

Return to the top 100 profitable addresses

Parameter	Type	Required	Description
chainIndex	String	Yes	Unique identifier of the chain. For example: `1`: Ethereum.
tokenContractAddress	String	Yes	Token contract address (e.g. 0x382bb369d343125bfb2117af9c149795c6c65c50)
tagFilter	String	No	Default: No input, return the address data of the top 100 profitable addresses, arranged in reverse order according to the realized income. Enter 1: Return the holding address labeled KOL. Enter 2: Return the token address labeled Developer Enter 3: Return the holding address labeled Smart Money Enter 4: Return the holding address labeled as Whale Enter 5: Return the holding address labeled New Wallet Enter 6: Return the holding address labeled Suspicious Enter 7: Return the holding address labeled Sniper Enter 8: Return the holding address labeled as Suspected phishing. Enter 9: Return the holding address labeled Bundle

Response Parameters#

Field	Type	Description
holderWalletAddress	String	Cash holding address
holdAmount	String	Number of coins held
holdPercent	String	Percentage of holdings
nativeTokenBalance	String	Mainnet currency balance
boughtAmount	String	Total Buy Quantity
avgBuyPrice	String	Average buying price
soldAmount	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

Token Holder Information

Error Codes

Request Example#

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'

Response Example#

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": ""
}

Token Holder Information

Error Codes