跳转到主要内容
GET
/
v2
/
pnl
/
leaderboard
/
top
SDK
import { Client } from '@solana-tracker/data-api';

const client = new Client({ apiKey: 'YOUR_API_KEY' });

const data = await client.getPnlV2TopTraders({ limit: 50, pnlMode: 'strict' });
{
  "traders": [
    {
      "wallet": "HkFGQsW8mr8DTC2AE2WcC7MzwSnynfEryGMQSht271nf",
      "period": {
        "realized": 29253686.75,
        "realizedRaw": 29511824.12,
        "volume": 53377270.16,
        "tradingDays": 79,
        "roi": 345.12,
        "days": {
          "profitable": 58,
          "losing": 21,
          "maxSinglePnl": 891245.33,
          "winRate": 73.42
        }
      },
      "pnlAdjustments": {
        "mode": "adjusted",
        "invalidPnl": 29511824.12,
        "adjustedCorrection": 258137.37
      },
      "ending": {
        "pnl": {
          "realized": 29642991.91,
          "total": 29684935.07
        }
      },
      "invested": 8476262.08,
      "proceeds": 38119253.99,
      "counts": {
        "buys": 13842,
        "sells": 27968,
        "trades": 41810,
        "tokensTraded": 4689
      },
      "averages": {
        "buy": 1168.23,
        "sell": 1362.96
      },
      "tokens": {
        "profitable": 2441,
        "losing": 159,
        "closed": 2600
      },
      "winRate": 93.88,
      "timing": {
        "firstTrade": 1736769677989,
        "lastTrade": 1776617215655
      },
      "lastSnapshotDate": "2026-04-19",
      "updatedAt": "2026-04-19T16:46:56.831Z",
      "identity": {
        "name": null,
        "twitter": null,
        "avatar": "https://kol-avatar.solanatracker.io/HkFGQsW8mr8DTC2AE2WcC7MzwSnynfEryGMQSht271nf"
      }
    },
    {
      "wallet": "ApAKzJEqfnP7F74Za5xdTQxZMK4nD8dFTVBQ9bksTtGM",
      "period": {
        "realized": 19624090.03,
        "volume": 34214876.02,
        "tradingDays": 51,
        "roi": 394.24
      },
      "ending": {
        "pnl": {
          "realized": 19769219.5,
          "total": 19768875.79
        }
      },
      "invested": 4977742.44,
      "proceeds": 24746961.94,
      "counts": {
        "buys": 8655,
        "sells": 20887,
        "trades": 29542,
        "tokensTraded": 2915
      },
      "averages": {
        "buy": 1119.37,
        "sell": 1184.8
      },
      "tokens": {
        "profitable": 1811,
        "losing": 33,
        "closed": 1844
      },
      "winRate": 98.21,
      "timing": {
        "firstTrade": 1772358151760,
        "lastTrade": 1776607936649
      },
      "lastSnapshotDate": "2026-04-19",
      "updatedAt": "2026-04-19T14:12:17.583Z",
      "identity": {
        "name": null,
        "twitter": null,
        "avatar": "https://kol-avatar.solanatracker.io/ApAKzJEqfnP7F74Za5xdTQxZMK4nD8dFTVBQ9bksTtGM"
      }
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "eyJzb3J0VmFsdWUiOjE5NjI0MDkwLjAyODk1MTU5MywidGllQnJlYWtlciI6IkFwQUt6SkVxZm5QN0Y3NFphNXhkVFF4Wk1LNG5EOGRGVFZCUTlia3NUdEdNIn0=",
    "count": 2,
    "total": 2,
    "pnlMode": "adjusted"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.solanatracker.io/llms.txt

Use this file to discover all available pages before exploring further.

SDK Example

import { Client } from '@solana-tracker/data-api';

const client = new Client({ apiKey: 'YOUR_API_KEY' });

const data = await client.getPnlV2TopTraders({ limit: 50, pnlMode: 'strict' });

授权

x-api-key
string
header
必填

用于鉴权的 API Key

查询参数

sort
enum<string>
默认值:realized

排序字段

可用选项:
realized,
volume,
days,
roi,
win_percentage,
trades,
tokens
direction
enum<string>
默认值:desc

排序方向

可用选项:
asc,
desc
limit
integer
默认值:100

每页条数

cursor
string

分页游标,取自上一页响应的 pagination.nextCursor

platform
enum<string>

按交易平台筛选交易者(逗号分隔)

可用选项:
axiom,
axiom-flash,
bloom,
photon
excludeArbitrage
enum<string>
默认值:true

默认排除标为套利机器人的钱包;传 false 则包含

可用选项:
true,
false
pnlMode
enum<string>
默认值:strict

对被无效 PnL 启发式标记的仓位:strict 归零;adjusted 按成本基础封顶;raw 不改动已实现盈亏。API 也接受别名 pnl_modemode

可用选项:
strict,
adjusted,
raw
days
integer
默认值:90

排行榜滚动窗口(天)。请使用 1、7、30 或 90;其他取值由 API 近似到最近支持窗口。

minTrades
integer
默认值:20

窗口内最少成交笔数

minInvested
number
默认值:1

窗口内最低投入(美元)

minDays
integer
默认值:3

最少活跃交易日数

minWinRate
number

最低胜率(%)

minRoi
number

最低 ROI(%)

minClosedTokens
integer

最少已平仓笔数

maxSingleTokenPct
number

单笔代币贡献盈利占比上限,用于过滤「一发暴富」型地址

响应

Successful response.

traders
object[]
pagination
object

Cursor-based pagination metadata.