> ## 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.

# Get Wallet Highlights

> 突出仓位摘要：最大盈利、最大亏损、当前最大持仓、最短换手、最长持有、成交最多代币等。

## SDK Example

<CodeGroup>
  ```typescript SDK
  import { Client } from '@solana-tracker/data-api';

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

  const data = await client.getPnlV2WalletHighlights('FbMxP3GVq8TQ36nbYgx4NP9iygMpwAwFWJwW81ioCiSF');

  ```
</CodeGroup>


## OpenAPI

````yaml /cn/data-api/pnl-v2/openapi.json get /v2/pnl/wallets/{wallet}/highlights
openapi: 3.1.0
info:
  title: SolanaTracker PnL V2 API
  description: >-
    面向 Solana 钱包的盈亏追踪：钱包级 PnL 汇总、按代币的持仓、排行榜、KOL 榜单、风险分析与历史表现。金额均为美元；除另有说明外，时间戳均为
    Unix 毫秒。
  version: 2.0.0
servers:
  - url: https://data.solanatracker.io
    description: 生产环境
security:
  - apiKey: []
tags:
  - name: Leaderboard
    description: 顶尖交易者、巨鲸与 KOL 排名
  - name: Token
    description: 按代币的交易者与持币数据
  - name: Wallet
    description: 钱包级盈亏、持仓、历史与分析
  - name: Batch
    description: 批量钱包摘要与持仓查询
paths:
  /v2/pnl/wallets/{wallet}/highlights:
    get:
      tags:
        - Wallet
      summary: Get Wallet Highlights
      description: 突出仓位摘要：最大盈利、最大亏损、当前最大持仓、最短换手、最长持有、成交最多代币等。
      operationId: getWalletHighlights
      parameters:
        - $ref: '#/components/parameters/walletPath'
        - $ref: '#/components/parameters/pnlMode'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  wallet:
                    type: string
                  identity:
                    $ref: '#/components/schemas/Identity'
                  counts:
                    type: object
                    properties:
                      positions:
                        type: integer
                      open:
                        type: integer
                      closed:
                        type: integer
                  highlights:
                    type: object
                    properties:
                      biggestWinner:
                        oneOf:
                          - $ref: '#/components/schemas/Position'
                          - type: 'null'
                        description: Position with the highest total PnL.
                      biggestLoser:
                        oneOf:
                          - $ref: '#/components/schemas/Position'
                          - type: 'null'
                        description: Position with the lowest (most negative) total PnL.
                      biggestBag:
                        oneOf:
                          - $ref: '#/components/schemas/Position'
                          - type: 'null'
                        description: Currently-held position with the highest USD value.
                      mostProfitableClosed:
                        oneOf:
                          - $ref: '#/components/schemas/Position'
                          - type: 'null'
                        description: Fully-closed position with the highest realized PnL.
                      fastestFlip:
                        oneOf:
                          - $ref: '#/components/schemas/Position'
                          - type: 'null'
                        description: Closed position with the shortest hold time.
                      longestHold:
                        oneOf:
                          - $ref: '#/components/schemas/Position'
                          - type: 'null'
                        description: Position held for the longest time.
                      mostActive:
                        oneOf:
                          - $ref: '#/components/schemas/Position'
                          - type: 'null'
                        description: Position with the most total transactions.
                  updatedAt:
                    type:
                      - string
                      - 'null'
                    format: date-time
              example:
                wallet: CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o
                identity:
                  name: Cented
                  twitter: '@Cented7'
                  avatar: >-
                    https://kol-avatar.solanatracker.io/CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o
                  platforms:
                    - axiom
                    - bloom
                  type: kol
                  tags:
                    - kol
                    - axiom
                    - bloom
                counts:
                  positions: 78195
                  open: 67
                  closed: 78038
                highlights:
                  biggestWinner:
                    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
                  biggestLoser:
                    token: 7oBYdEhV4GkXC19ZfgAvXpJWp2Rn9pm1Bx2cVNxFpump
                    pnl:
                      realized: -35871.5
                      unrealized: 0
                      total: -35871.5
                    invested: 198100.82
                    proceeds: 162229.32
                    roi: -18.11
                    current:
                      balance: 0
                      costBasis: 0
                      value: 0
                      price: 0.002354211655338213
                      avgCost: 0
                    volume:
                      tokensBought: 691468.7852680003
                      tokensSold: 691468.7852680003
                      buyUsd: 198100.82
                      sellUsd: 162229.32
                    averages:
                      buy: 66033.61
                      sell: 7374.06
                    counts:
                      buys: 3
                      sells: 22
                      total: 25
                    timing:
                      firstBuy: 1739143473034
                      lastBuy: 1739145831076
                      firstSell: 1739145761662
                      lastSell: 1739147344056
                      firstTrade: 1739143473034
                      lastTrade: 1739147344056
                      holdTimeSecs: 3871
                    meta:
                      symbol: CAR
                      name: Central African Republic Meme
                      image: >-
                        https://image.solanatracker.io/proxy?url=https%3A%2F%2Fipfs-forward.solanatracker.io%2Fipfs%2FQmbwDLvzQA1DB9ZY7vfRSCogwdvAj3zCDuB9XN5pcmuawz
                      decimals: 6
                      price: 0.002354211655338213
                      snapshotPrice: 0.0023011473311510314
                      marketCap: 2344699.1
                      liquidity: 241439.84
                      primaryMarket: raydium
                  biggestBag:
                    token: FJEMUVcjUYu25i5XgMziVTWYq3D8KbXPL6WStJcXpump
                    pnl:
                      realized: 225.1
                      unrealized: 707.38
                      total: 932.48
                    invested: 474.23
                    proceeds: 699.33
                    roi: 196.63
                    current:
                      balance: 40599697.119731
                      costBasis: 0
                      value: 707.38
                      price: 0.000017423193567054
                      avgCost: 5.591174715677386e-21
                    volume:
                      tokensBought: 40599697.119730994
                      tokensSold: 40599697.119730994
                      buyUsd: 474.23
                      sellUsd: 699.33
                    averages:
                      buy: 237.11
                      sell: 699.33
                    counts:
                      buys: 2
                      sells: 1
                      total: 3
                    timing:
                      firstBuy: 1776377440861
                      lastBuy: 1776377487794
                      firstSell: 1776378122098
                      lastSell: 1776378122098
                      firstTrade: 1776377440861
                      lastTrade: 1776378122098
                      holdTimeSecs: 245569
                    meta:
                      symbol: Scientists
                      name: Dead Scientists Theory
                      image: >-
                        https://image.solanatracker.io/proxy?url=https%3A%2F%2Fmetadata.rapidlaunch.io%2Fimages%2F83686cf6-5651-4149-8306-b67e5688424d.png
                      decimals: 6
                      price: 0.000017423193567054
                      snapshotPrice: 0.000020509681344903
                      marketCap: 17413.69
                      liquidity: 10331.32
                      primaryMarket: pumpfun-amm
                  mostProfitableClosed:
                    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
                  fastestFlip:
                    token: Bx6V7NaoqsbUWzhgQCFAFhZuaQy8iovi86RfubWU1PWH
                    pnl:
                      realized: 814.17
                      unrealized: 0
                      total: 814.17
                    invested: 0
                    proceeds: 814.17
                    roi: null
                    current:
                      balance: 0
                      costBasis: 0
                      value: 0
                      price: 0.000002357263778848
                      avgCost: 0
                    volume:
                      tokensBought: 29809000.59533
                      tokensSold: 29809000.59533
                      buyUsd: 447.1
                      sellUsd: 814.17
                    averages:
                      buy: 447.1
                      sell: 407.08
                    counts:
                      buys: 1
                      sells: 2
                      total: 3
                    timing:
                      firstBuy: 1745554270946
                      lastBuy: 1745554270946
                      firstSell: 1745549335843
                      lastSell: 1745549339911
                      firstTrade: 1745549335843
                      lastTrade: 1745554270946
                      holdTimeSecs: 0
                    meta:
                      symbol: PEPELON
                      name: Pepelon
                      image: >-
                        https://image.solanatracker.io/proxy?url=https%3A%2F%2Fimage.solanatracker.io%2Fproxy%3Furl%3Dhttps%253A%252F%252Fpbs.twimg.com%252Fmedia%252FGpWS1psWYAAgLm-.png
                      decimals: 6
                      price: 0.000002357263778848
                      snapshotPrice: 0.000003945957287888344
                      marketCap: 2357.26
                      liquidity: 5054.15
                      primaryMarket: pumpfun
                  longestHold:
                    token: 8fne3nyZSHYFnsGTt859HDLbsXM9hNFT8Gq22RRbvuxc
                    pnl:
                      realized: 0
                      unrealized: -179.11
                      total: -179.11
                    invested: 0
                    proceeds: 0
                    roi: null
                    current:
                      balance: 4475937.022667
                      costBasis: 189.7
                      value: 10.59
                      price: 0.000002365334430144
                      avgCost: 0.000042382231805392984
                    volume:
                      tokensBought: 4475937.022667
                      tokensSold: 0
                      buyUsd: 189.7
                      sellUsd: 0
                    averages:
                      buy: 189.7
                      sell: 0
                    counts:
                      buys: 1
                      sells: 0
                      total: 1
                    timing:
                      firstBuy: 1738899285533
                      lastBuy: 1738899285533
                      firstSell: null
                      lastSell: null
                      firstTrade: 1738899285533
                      lastTrade: 1738899285533
                      holdTimeSecs: 37723724
                    meta:
                      symbol: $AXION
                      name: Axion Framework
                      image: >-
                        https://image.solanatracker.io/proxy?url=https%3A%2F%2Fipfs-forward.solanatracker.io%2Fipfs%2FQmYsuhoxj4v35uv8K6CUGQNEDgGucg7ybp4uqoZM9apDhx
                      decimals: 6
                      price: 0.000002365334430144
                      snapshotPrice: 0.0000023653344301436163
                      marketCap: 2365.33
                      liquidity: 5018.68
                      primaryMarket: pumpfun
                  mostActive:
                    token: E2BLSv4tXo7qA4Pr3nkJqxyn6743peC7x8E9D5s8pump
                    pnl:
                      realized: 35884.26
                      unrealized: 0
                      total: 35884.26
                    invested: 6690.39
                    proceeds: 42574.66
                    roi: 536.36
                    current:
                      balance: 0
                      costBasis: 0
                      value: 0
                      price: 0.000022142554130625
                      avgCost: 0
                    volume:
                      tokensBought: 122569339.995265
                      tokensSold: 122569339.99526508
                      buyUsd: 6690.39
                      sellUsd: 42574.66
                    averages:
                      buy: 91.65
                      sell: 351.86
                    counts:
                      buys: 73
                      sells: 121
                      total: 194
                    timing:
                      firstBuy: 1769117570519
                      lastBuy: 1769134040307
                      firstSell: 1769123662333
                      lastSell: 1769135327800
                      firstTrade: 1769117570519
                      lastTrade: 1769135327800
                      holdTimeSecs: 17757
                    meta:
                      symbol: yomama
                      name: Yo mama
                      image: >-
                        https://image.solanatracker.io/proxy?url=https%3A%2F%2Fipfs-forward.solanatracker.io%2Fipfs%2Fbafkreiamgabzlyyt7jzebir3hospfpazcbicjz6qd6nvwgfx3ymjqzmu6y
                      decimals: 6
                      price: 0.000022142554130625
                      snapshotPrice: 0.00002732853125871991
                      marketCap: 22135.64
                      liquidity: 16337.62
                      primaryMarket: pumpfun-amm
                updatedAt: '2026-04-19T17:53:30.439Z'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-codeSamples:
        - lang: typescript
          label: SDK
          source: >
            import { Client } from '@solana-tracker/data-api';


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


            const data = await
            client.getPnlV2WalletHighlights('FbMxP3GVq8TQ36nbYgx4NP9iygMpwAwFWJwW81ioCiSF');
      x-code-samples:
        - lang: typescript
          label: SDK
          source: >
            import { Client } from '@solana-tracker/data-api';


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


            const data = await
            client.getPnlV2WalletHighlights('FbMxP3GVq8TQ36nbYgx4NP9iygMpwAwFWJwW81ioCiSF');
components:
  parameters:
    walletPath:
      name: wallet
      in: path
      required: true
      description: Solana 钱包地址（Base58，约 32–44 字符）
      schema:
        type: string
        pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
    pnlMode:
      name: pnlMode
      in: query
      description: >-
        对被无效 PnL 启发式标记的仓位：`strict` 归零；`adjusted` 按成本基础封顶；`raw` 不改动已实现盈亏。API
        也接受别名 `pnl_mode` 与 `mode`。
      schema:
        type: string
        enum:
          - strict
          - adjusted
          - raw
        default: strict
  schemas:
    Identity:
      type: object
      description: >-
        Unified wallet identity. Only fields with known values are returned; a
        wallet can carry multiple tags at once.
      properties:
        name:
          type:
            - string
            - 'null'
          description: Display name, if known.
        twitter:
          type:
            - string
            - 'null'
          description: Twitter/X handle, if known.
        avatar:
          type:
            - string
            - 'null'
          format: uri
          description: Avatar image URL.
        type:
          type:
            - string
            - 'null'
          description: >-
            Primary label for single-badge UIs, such as `kol`, `developer`,
            `pool`, `bot`, `hacker`, `spam_dusting`, `exchange`, or a platform
            tag.
        tags:
          type: array
          items:
            type: string
          description: >-
            All resolved labels for the wallet, including KOL, platform, pool,
            developer, bot, arbitrage, hacker, spam-dusting, or exchange tags.
        platforms:
          type: array
          items:
            type: string
          description: >-
            Normalized trading frontend tags such as `axiom`, `bloom`, or
            `photon`. Query filters also accept `axiom-flash`, which is
            normalized to `axiom` in identity responses.
        bot:
          type: object
          properties:
            name:
              type:
                - string
                - 'null'
            avatar:
              type:
                - string
                - 'null'
              format: uri
        pool:
          type: object
          properties:
            program:
              type:
                - string
                - 'null'
            poolAddress:
              type:
                - string
                - 'null'
        developer:
          type: object
          properties:
            token:
              type:
                - string
                - 'null'
            via:
              type: array
              items:
                type: string
            pools:
              type: array
              items:
                type: string
            creationTx:
              type:
                - string
                - 'null'
            createdAt:
              type:
                - integer
                - 'null'
              description: Unix timestamp in seconds.
        hacker:
          type: object
          description: Curated exploit/scam wallet label, when known.
          properties:
            label:
              type:
                - string
                - 'null'
        spamDusting:
          type: object
          description: Curated spam-dusting wallet label, when known.
          properties:
            label:
              type:
                - string
                - 'null'
        exchange:
          type: object
          description: Known centralized exchange hot wallet label, when known.
          properties:
            name:
              type:
                - string
                - 'null'
    Position:
      type: object
      description: A single token position for a wallet.
      properties:
        token:
          type: string
          description: Token mint address (base58).
        pnl:
          $ref: '#/components/schemas/PnlBlock'
        invested:
          type:
            - number
            - 'null'
          description: Total cost basis (USD spent buying this token).
        proceeds:
          type:
            - number
            - 'null'
          description: Total USD received from sales of this token.
        roi:
          type:
            - number
            - 'null'
          description: Return on investment percentage.
        current:
          type: object
          properties:
            balance:
              type:
                - number
                - 'null'
              description: Current token balance (native units).
            costBasis:
              type:
                - number
                - 'null'
              description: Cost basis of remaining held tokens.
            value:
              type:
                - number
                - 'null'
              description: Current USD value of held tokens.
            price:
              type:
                - number
                - 'null'
              description: Current token price in USD.
            avgCost:
              type:
                - number
                - 'null'
              description: Average cost per token in USD.
        volume:
          type: object
          properties:
            tokensBought:
              type:
                - number
                - 'null'
              description: Total tokens purchased (native units).
            tokensSold:
              type:
                - number
                - 'null'
              description: Total tokens sold (native units).
            buyUsd:
              type:
                - number
                - 'null'
              description: Total USD spent on buys.
            sellUsd:
              type:
                - number
                - 'null'
              description: Total USD received from sells.
        averages:
          type: object
          properties:
            buy:
              type:
                - number
                - 'null'
              description: Average buy size in USD.
            sell:
              type:
                - number
                - 'null'
              description: Average sell size in USD.
        counts:
          type: object
          properties:
            buys:
              type: integer
            sells:
              type: integer
            total:
              type: integer
              description: Total transactions (buys + sells).
        timing:
          type: object
          properties:
            firstBuy:
              type:
                - integer
                - 'null'
              description: Unix ms.
            lastBuy:
              type:
                - integer
                - 'null'
              description: Unix ms.
            firstSell:
              type:
                - integer
                - 'null'
              description: Unix ms.
            lastSell:
              type:
                - integer
                - 'null'
              description: Unix ms.
            firstTrade:
              type:
                - integer
                - 'null'
              description: Unix ms.
            lastTrade:
              type:
                - integer
                - 'null'
              description: Unix ms.
            holdTimeSecs:
              type:
                - integer
                - 'null'
              description: How long the position has been (or was) held, in seconds.
        meta:
          $ref: '#/components/schemas/TokenMeta'
        portfolioPercent:
          type:
            - number
            - 'null'
          description: >-
            This position's value as a percentage of the wallet's total holdings
            value. Only present on the positions endpoint.
    Error:
      type: object
      properties:
        error:
          type: string
          description: Human-readable error message.
      required:
        - error
    PnlBlock:
      type: object
      description: Realized, unrealized, and total profit/loss in USD.
      properties:
        realized:
          type:
            - number
            - 'null'
          description: Profit/loss from closed trades (tokens fully or partially sold).
        realizedRaw:
          type:
            - number
            - 'null'
          description: >-
            Unfiltered realized PnL before `pnlMode` adjustments. Present on
            position rows and leaderboard period stats when available.
        unrealized:
          type:
            - number
            - 'null'
          description: >-
            Paper profit/loss on tokens still held, based on current market
            price.
        total:
          type:
            - number
            - 'null'
          description: Sum of realized + unrealized PnL.
    TokenMeta:
      type: object
      description: Basic token metadata and current market data.
      properties:
        symbol:
          type:
            - string
            - 'null'
        name:
          type:
            - string
            - 'null'
        decimals:
          type:
            - integer
            - 'null'
        price:
          type:
            - number
            - 'null'
          description: Current price in USD.
        liquidity:
          type:
            - number
            - 'null'
          description: Current liquidity in USD.
        marketCap:
          type:
            - number
            - 'null'
          description: Current market cap in USD.
        primaryMarket:
          type:
            - string
            - 'null'
          description: Primary DEX where this token trades (e.g. Raydium, Orca).
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: 用于鉴权的 API Key

````