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

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

const data = await client.getPnlV2WalletPositions('FbMxP3GVq8TQ36nbYgx4NP9iygMpwAwFWJwW81ioCiSF', { limit: 50 });
{
  "wallet": "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o",
  "identity": {
    "name": "Cented",
    "twitter": "@Cented7",
    "avatar": "https://kol-avatar.solanatracker.io/CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o",
    "platforms": [
      "axiom",
      "bloom"
    ],
    "type": "kol",
    "tags": [
      "kol",
      "axiom",
      "bloom"
    ]
  },
  "positions": [
    {
      "token": "38PgzpJYu2HkiYvV8qePFakB8tuobPdGm2FFEn7Dpump",
      "pnl": {
        "realized": 88872.66,
        "unrealized": 0,
        "total": 88872.66
      },
      "invested": 3071.27,
      "proceeds": 91943.94,
      "roi": 2893.67,
      "current": {
        "balance": 0,
        "costBasis": 0,
        "value": 0,
        "price": 0.001490308105474092,
        "avgCost": 0
      },
      "volume": {
        "tokensBought": 46026806.173715,
        "tokensSold": 46026806.173715,
        "buyUsd": 3071.27,
        "sellUsd": 91943.94
      },
      "averages": {
        "buy": 341.25,
        "sell": 1242.49
      },
      "counts": {
        "buys": 9,
        "sells": 74,
        "total": 83
      },
      "timing": {
        "firstBuy": 1746044721229,
        "lastBuy": 1772031549416,
        "firstSell": 1746044751527,
        "lastSell": 1772032040873,
        "firstTrade": 1746044721229,
        "lastTrade": 1772032040873,
        "holdTimeSecs": 25987320
      },
      "meta": {
        "symbol": "gork",
        "name": "New XAI gork",
        "image": "https://image.solanatracker.io/proxy?url=https%3A%2F%2Fipfs-forward.solanatracker.io%2Fipfs%2FQmXkHvTBRFMyY5ozYHXcF7JHqqLBTorca3dXAdF3ooD5e3",
        "decimals": 6,
        "price": 0.001490308105474092,
        "snapshotPrice": 0.001666646257827002,
        "marketCap": 1489948.99,
        "liquidity": 371378.83,
        "primaryMarket": "pumpfun-amm"
      },
      "portfolioPercent": 0
    },
    {
      "token": "84cAEWqiDsV5xXh6CB69Hi3HcnumBbdjH4THfyorpump",
      "pnl": {
        "realized": 50791.19,
        "unrealized": 0,
        "total": 50791.19
      },
      "invested": 2621.72,
      "proceeds": 53412.92,
      "roi": 1937.32,
      "current": {
        "balance": 0,
        "costBasis": 0,
        "value": 0,
        "price": 0.000016173713662274,
        "avgCost": 0
      },
      "volume": {
        "tokensBought": 96296057.47450998,
        "tokensSold": 96296057.47451006,
        "buyUsd": 2621.72,
        "sellUsd": 53412.92
      },
      "averages": {
        "buy": 70.86,
        "sell": 346.84
      },
      "counts": {
        "buys": 37,
        "sells": 154,
        "total": 191
      },
      "timing": {
        "firstBuy": 1774277622281,
        "lastBuy": 1774294723039,
        "firstSell": 1774277870173,
        "lastSell": 1774296331666,
        "firstTrade": 1774277622281,
        "lastTrade": 1774296331666,
        "holdTimeSecs": 18709
      },
      "meta": {
        "symbol": "7",
        "name": "The 7 Wanderers",
        "image": "https://image.solanatracker.io/proxy?url=https%3A%2F%2Fedge.uxento.io%2Fimage%2FBxu1Dr8rLNBDyEutHRapKLdquDLeZkn8zkiUn9Avpump",
        "decimals": 6,
        "price": 0.000016173713662274,
        "snapshotPrice": 0.000022584238960459607,
        "marketCap": 16168.06,
        "liquidity": 14118.7,
        "primaryMarket": "pumpfun-amm"
      },
      "portfolioPercent": 0
    }
  ],
  "stats": {
    "total": 78195,
    "filtered": 78195,
    "holding": 67,
    "sold": 77978,
    "profitable": 47817,
    "losing": 30175
  },
  "pagination": {
    "hasMore": true,
    "nextCursor": "eyJzb3J0VmFsdWUiOjUwNzkxLjE5Mzc4MjkwNzc5NCwidGllQnJlYWtlciI6Ijg0Y0FFV3FpRHNWNXhYaDZDQjY5SGkzSGNudW1CYmRqSDRUSGZ5b3JwdW1wIn0=",
    "count": 2,
    "total": 78195,
    "pnlMode": "strict"
  }
}

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.getPnlV2WalletPositions('FbMxP3GVq8TQ36nbYgx4NP9iygMpwAwFWJwW81ioCiSF', { limit: 50 });

授权

​
x-api-key
string
header
必填

用于鉴权的 API Key

路径参数

​
wallet
string
必填

Solana 钱包地址（Base58，约 32–44 字符）

Pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$

查询参数

​
pnlMode
enum<string>
默认值:strict

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

可用选项:
strict,
adjusted,
raw
​
sort
enum<string>
默认值:last_trade

持仓排序字段

可用选项:
last_trade,
pnl,
realized,
unrealized,
roi,
value,
holding,
invested,
cost,
proceeds,
buys,
sells
​
direction
enum<string>
默认值:desc

排序方向

可用选项:
asc,
desc
​
cursor
string

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

​
limit
integer
默认值:100

每页条数（1–200）

必填范围: x <= 200
​
filter
enum<string>
默认值:all

按持仓状态筛选

可用选项:
all,
holding,
active,
sold,
profitable,
losing
​
period
enum<string>
默认值:all

仅显示该时间段内有活动的仓位

可用选项:
1d,
7d,
14d,
30d,
90d,
all
​
tokens
string

筛选用的代币 mint 地址列表（逗号分隔），最多 100 个

​
minValue
number

仓位当前价值下限（美元）

​
maxValue
number

仓位当前价值上限（美元）

​
minPnl
number

总盈亏下限（美元）

​
maxPnl
number

总盈亏上限（美元）

​
minInvested
number

总投入下限（美元）

​
maxInvested
number

总投入上限（美元）

​
minRoi
number

最低 ROI（%）

​
maxRoi
number

最高 ROI（%）

​
minTrades
integer

最低成交笔数

​
minHolding
number

最低代币余额（原生单位）

​
market
string

按主要市场/DEX 筛选（如 Raydium、Orca）

​
minLiquidity
number

代币最低流动性（美元）

​
minMarketCap
number

代币最低市值（美元）

响应

Successful response.

​
wallet
string
​
identity
object

Unified wallet identity. Only fields with known values are returned; a wallet can carry multiple tags at once.

​
positions
object[]
​
stats
object

Position counts across the entire wallet (not just this page).

​
pagination
object

Cursor-based pagination metadata.