获取聪明钱榜单列表#
获取指定排序和筛选项下的聪明钱榜单列表，可搭配信号 API 功能一起使用。
限制：单次请求最多 20 条
请求路径#
GET https://web3.okx.com/api/v6/dex/market/leaderboard/list
请求参数#
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| chainIndex | string | 是 | 链的唯一标识，传入链的 ID（如 501: Solana），仅支持单链查询 |
| timeFrame | string | 是 | 地址交易及收益的统计范围编号（如：1=1D，2=3D，3=7D，4=1M，5=3M） |
| sortBy | string | 是 | 排序按照选定 timeFrame 中的：PnL、ProfitRate、WinRate、TxVolume、TxCount。1=Pnl，2=Win Rate，3=Tx number，4=Volume，5=ROI (profit rate) |
| walletType | string | 否 | 钱包类型编号，包括 Sniper、DEV、Fresh、Pump smart money、influencer，支持单一选中，不传则返回全部类型地址排行 |
| minRealizedPnlUsd | string | 否 | 已实现盈亏金额（美元）的最小值 |
| maxRealizedPnlUsd | string | 否 | 已实现盈亏金额（美元）的最大值 |
| minWinRatePercent | string | 否 | 胜率百分比的最小值 |
| maxWinRatePercent | string | 否 | 胜率百分比的最大值 |
| minTxs | string | 否 | 交易笔数的最小值 |
| maxTxs | string | 否 | 交易笔数的最大值 |
| minTxVolume | string | 否 | 交易金额（美元）的最小值 |
| maxTxVolume | string | 否 | 交易金额（美元）的最大值 |
响应参数#
| 参数 | 类型 | 描述 |
|---|---|---|
| walletAddress | string | 钱包地址 |
| realizedPnlUsd | string | 选定时间范围内完成的交易的累计已实现盈亏美元价值 |
| realizedPnlPercent | string | 选定时间范围内完成的交易的累计已实现盈亏百分比 |
| winRatePercent | string | 盈利代币相对于交易代币总数的胜率百分比 |
| avgBuyValueUsd | string | 平均购买价值 |
| topPnlTokenList | array | PnL 排名前 3 的代币列表 |
| > tokenContractAddress | string | 代币合约地址 |
| > tokenSymbol | string | 代币符号 |
| > tokenPnlUsd | string | 代币盈亏（美元） |
| > tokenPnlPercent | string | 代币盈亏百分比 |
| txVolume | string | 选定时间范围内交易金额（美元） |
| txs | string | 选定时间范围内交易笔数 |
| lastActiveTimestamp | string | 末次活跃时间 |
请求示例#
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'
响应示例#
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": ""
}