Get Smart Money Leaderboard List#
Retrieve the Smart Money leaderboard according to specified sorting and filter options; can be used in conjunction with the Signal API.
Limit: Maximum 20 records per request
Request Path#
GET https://web3.okx.com/api/v6/dex/market/leaderboard/list
Request Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| chainIndex | string | Yes | Unique chain identifier (e.g., 1 for Ethereum). Only supports single-chain queries |
| timeFrame | string | Yes | Address transactions and PnL timeframe index (i.e. 1=1D, 2=3D, 3=7D, 4=1M, 5=3M) |
| sortBy | string | Yes | Sorting according to the selected timeFrame: PnL, ProfitRate, WinRate, TxVolume, TxCount. 1=Pnl, 2=Win Rate, 3=Tx number, 4=Volume, 5=ROI (profit rate) |
| walletType | string | No | Wallet types index, including Sniper, DEV, Fresh, Pump smart money, and influencer, support single selection. If not passed, the ranking of all types of addresses will be returned |
| minRealizedPnlUsd | string | No | Minimum realized profit and loss amount (USD) |
| maxRealizedPnlUsd | string | No | Maximum realized profit and loss amount (USD) |
| minWinRatePercent | string | No | Minimum win rate percentage |
| maxWinRatePercent | string | No | Maximum win rate percentage |
| minTxs | string | No | Minimum number of transactions |
| maxTxs | string | No | Maximum number of transactions |
| minTxVolume | string | No | Minimum transaction volume (USD) |
| maxTxVolume | string | No | Maximum transaction volume (USD) |
Response Parameters#
| Field | Type | Description |
|---|---|---|
| walletAddress | string | Wallet address |
| realizedPnlUsd | string | Accumulated realized PnL USD value for completed transactions within the selected timeframe |
| realizedPnlPercent | string | Accumulated realized PnL percentage for completed transactions within the selected timeframe |
| winRatePercent | string | The percentage of profitable tokens relative to the total number of tokens traded |
| avgBuyValueUsd | string | Average buy value |
| topPnlTokenList | array | Top 3 token list by PnL |
| > tokenContractAddress | string | Token contract address |
| > tokenSymbol | string | Token symbol |
| > tokenPnlUsd | string | Token PnL in USD |
| > tokenPnlPercent | string | Token PnL percentage |
| txVolume | string | Transaction volume in USD within the selected timeframe |
| txs | string | Transaction count within the selected timeframe |
| lastActiveTimestamp | string | Last active time |
Request Example#
Shell
curl --location --request GET 'https://web3.okx.com/api/v6/dex/market/leaderboard/list?chainIndex=501&timeFrame=1&sortBy=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": [
{
"walletAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
"realizedPnlUsd": "125430.56",
"realizedPnlPercent": "312.45",
"winRatePercent": "68.5",
"avgBuyValueUsd": "2340.00",
"topPnlTokenList": [
{
"tokenContractAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"tokenSymbol": "USDC",
"tokenPnlUsd": "45230.12",
"tokenPnlPercent": "156.78"
},
{
"tokenContractAddress": "So11111111111111111111111111111111111111112",
"tokenSymbol": "SOL",
"tokenPnlUsd": "38120.00",
"tokenPnlPercent": "98.34"
},
{
"tokenContractAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"tokenSymbol": "BONK",
"tokenPnlUsd": "20450.88",
"tokenPnlPercent": "204.60"
}
],
"txVolume": "890234.50",
"txs": "342",
"lastActiveTimestamp": "1697630501000"
}
],
"msg": ""
}