> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstream.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 錢包 - 按代幣淨值

> 取得錢包按代幣分類的淨值明細



## OpenAPI

````yaml /zh-Hant/api-reference/openapi-data-zh-Hant.yaml GET /v2/wallet/{chain}/{walletAddress}/net-worth/tokens
openapi: 3.1.0
info:
  title: Services API
  description: Services API
  contact:
    name: AI
    email: ai@sx.ai
  license:
    name: MIT
  version: '1.0'
servers:
  - url: https://api.chainstream.io
    description: Production
security:
  - bearer_auth: []
  - api_key_auth: []
tags:
  - name: Blockchain
    description: 區塊鏈相關操作
  - name: Token
    description: 代幣相關操作
  - name: Trade
    description: 交易相關操作
  - name: Wallet
    description: 錢包相關操作
  - name: Dex
    description: DEX 相關操作
  - name: Ranking
    description: 排行榜相關操作
  - name: DexPool
    description: DEX 池子相關操作
  - name: Watchlist
    description: 關注列表相關操作
  - name: KYT
    description: KYT 相關操作
  - name: Webhook
    description: Webhook 相關操作
  - name: RedPacket
    description: 紅包相關操作
  - name: IPFS
    description: IPFS 相關操作
  - name: DexScreener
    description: DexScreener 相關操作
paths:
  /v2/wallet/{chain}/{walletAddress}/net-worth/tokens:
    get:
      tags:
        - Wallet
      summary: 錢包 - 按代幣淨值
      description: 取得錢包按代幣分類的淨值明細
      operationId: get.net.worth.by.tokens
      parameters:
        - name: chain
          in: path
          description: 支援網路列表中的鏈名稱
          required: true
          schema:
            $ref: '#/components/schemas/ChainSymbol'
          example: sol
        - name: walletAddress
          in: path
          description: 錢包地址
          required: true
          schema:
            type: string
          example: BqxFPVYwiU68rWUfnYrREdf16psneAN4xbMpYgoUVeBJ
        - name: tokenAddresses
          in: query
          description: 代幣地址列表，以逗號 (,) 分隔的字串。最多允許 100 個代幣地址
          required: true
          schema:
            type: string
          example: >-
            EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v,So11111111111111111111111111111111111111112
      responses:
        '200':
          description: 成功回應
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NetWorthByTokensResult'
components:
  schemas:
    ChainSymbol:
      type: string
      description: Supported blockchain chains
      enum:
        - sol
        - eth
        - bsc
    NetWorthByTokensResult:
      type: object
      description: >-
        Wallet net-worth by tokens result (mirrors TS
        WalletNetWorthByTokensResult).
      required:
        - walletAddress
        - totalValueInUsd
        - totalValueInNative
        - currentTimestamp
        - data
      properties:
        currentTimestamp:
          type: string
          description: 目前伺服器時間戳
          example: '2025-10-30T03:33:40.980Z'
        data:
          type: array
          items:
            $ref: '#/components/schemas/NetWorthByTokensItem'
          description: 代幣淨值明細列表
        totalValueInNative:
          type: string
          description: 投資組合總價值（原生代幣計）
          example: '82.31'
        totalValueInUsd:
          type: string
          description: 投資組合總價值（USD 計）
          example: '12345.67'
        walletAddress:
          type: string
          description: 錢包地址
          example: 3xd4LGVWtYXLBspR6X5JWbW49NXmEehfPtX6Kqx98b4w
    NetWorthByTokensItem:
      type: object
      description: Single token net-worth item (mirrors TS WalletNetWorthItemDTO).
      required:
        - tokenAddress
        - decimals
        - priceInUsd
        - priceInNative
        - amount
        - valueInUsd
        - valueInNative
        - chain
        - name
        - symbol
        - isActive
      properties:
        accuAmount:
          type:
            - string
            - 'null'
          description: >-
            Accumulated net token position in token native units:

            buy_amount - sell_amount + transfer_in_amount - transfer_out_amount.

            Mirrors GMGN `accu_amount`. None when all four source fields are
            absent.
        amount:
          type: string
          description: 代幣持有數量
          example: '1000.50'
        avgCostUsd:
          type:
            - string
            - 'null'
          description: >-
            Average cost per token in USD (balance_cost_avg_in_usd; sparse ~0.2%
            fill rate)
        chain:
          type: string
          description: 區塊鏈網路標識
          example: sol
        decimals:
          type: integer
          format: int32
          description: 代幣小數位數
          example: 6
        isActive:
          type: boolean
          description: Whether the wallet currently holds a non-zero balance
        lastActiveAt:
          type:
            - integer
            - 'null'
          format: int64
          description: Last active timestamp (ms since epoch)
        logoUri:
          type:
            - string
            - 'null'
          description: 代幣 Logo URI
          example: https://s1.chainstream.io/tokens/images/usdc.webp
        name:
          type: string
          description: 代幣顯示名稱
          example: USD Coin
        priceInNative:
          type: string
          description: 代幣價格（原生代幣計）
          example: '0.00000667'
        priceInUsd:
          type: string
          description: 代幣價格（USD 計）
          example: '1.0001'
        realizedPnlInUsd:
          type:
            - string
            - 'null'
          description: Realized PnL in USD (all-time cumulative)
        symbol:
          type: string
          description: 代幣代號
          example: USDC
        tokenAddress:
          type: string
          description: 代幣合約地址
          example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
        unrealizedPnlInUsd:
          type:
            - string
            - 'null'
          description: Unrealized PnL in USD (current open position)
        valueInNative:
          type: string
          description: 持倉價值（原生代幣計）
          example: '6.67'
        valueInUsd:
          type: string
          description: 持倉價值（USD 計）
          example: '1000.60'
        walletTokenTags:
          type: array
          items:
            type: string
          description: Trader classification tags
  securitySchemes:
    bearer_auth:
      type: http
      scheme: bearer
      bearerFormat: JWT
    api_key_auth:
      type: apiKey
      in: header
      name: X-API-KEY

````