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

# Wallet - Portfolio (V2)

> Retrieve the portfolio and total asset value of a given wallet address.

<Tabs>
  <Tab title="Usage Note">
    <p><strong>Current Solana wallet portfolio and valuation.</strong></p>

    <ul>
      <li>This endpoint returns a current wallet portfolio snapshot with total asset value and paginated asset rows.</li>
      <li><code>limit</code> supports <code>1</code> to <code>100</code> items per request, and <code>offset</code> supports up to <code>10,000</code>.</li>
      <li><code>filter\_value</code> can be used to hide small positions below a minimum USD threshold.</li>
      <li><code>flags</code> can include additional portfolio behaviors such as <code>include\_low\_liquidity</code>.</li>
      <li><code>sort\_by</code> is currently value-oriented and <code>sort\_type</code> supports ascending or descending order.</li>
    </ul>
  </Tab>

  <Tab title="Accessibility">
    <ul>
      <li>Standard</li>
      <li>Lite</li>
      <li>Starter</li>
      <li>Premium</li>
      <li>Business</li>
      <li>Enterprise</li>
    </ul>
  </Tab>

  <Tab title="Chain Supported">
    <p><strong>Solana, Robinhood</strong></p>
  </Tab>
</Tabs>

<Accordion title="Compute Unit ⚙️" icon="fa-gauge-high">
  <ul>
    <li>This endpoint consumes <code>30 CU</code> per request.</li>
  </ul>
</Accordion>

<Accordion title="Use Cases 💡" icon="fa-lightbulb">
  <ul>
    <li>Show a wallet's current portfolio value and holdings breakdown.</li>
    <li>Power wallet overview pages, treasury dashboards, and portfolio snapshots.</li>
    <li>Filter out dust positions and focus on the holdings that matter.</li>
    <li>Rank or inspect one wallet's top assets before drilling into per-token PnL.</li>
  </ul>
</Accordion>

<Accordion title="How to Use 🛠️" icon="fa-book-open">
  <ul>
    <li>Set <code>x-chain=solana</code>.</li>
    <li>Pass the wallet address in <code>wallet</code>.</li>
    <li>Use <code>filter\_value</code> to suppress tiny positions.</li>
    <li>Page through holdings with <code>offset</code> and <code>limit</code>.</li>
  </ul>
</Accordion>

<Accordion title="Best Practices ✅" icon="fa-check-circle">
  <ul>
    <li>Use this as the primary current-portfolio endpoint instead of stitching holdings and prices manually.</li>
    <li>Apply <code>filter\_value</code> in UI views where dust assets would otherwise drown out signal.</li>
    <li>Cache per-wallet snapshots for a short interval rather than polling every interaction.</li>
  </ul>
</Accordion>

<Accordion title="Limitations ⚠️" icon="fa-exclamation-triangle">
  <ul>
    <li>Robinhood portfolio values use an effective valuation price and do not include historical balance-change data.</li>
  </ul>
</Accordion>

<br />


## OpenAPI

````yaml openapi/data/openapi_docs.json GET /wallet/v2/current-net-worth
openapi: 3.1.0
info:
  version: 1.1.0
  title: Birdeye Data API
  description: >-
    Birdeye Data API is a full-spectrum blockchain and DEX data platform for
    teams that need production-grade crypto market intelligence across tokens,
    pairs, wallets, traders, protocols, and chains.


    From real-time prices, OHLCV, liquidity, and transaction flow to holder
    analytics, token and pair overviews, wallet portfolio and PnL, smart money,
    discovery, security, and blockchain-level utilities, Birdeye gives you a
    unified data layer for building serious crypto products at scale.


    Use it to power exchange interfaces, trading terminals, bots, market-making
    systems, quant research, alpha screeners, portfolio apps, wallet
    intelligence tools, alerting systems, analytics dashboards, and back-office
    data pipelines. Whether your users are retail traders, pro desks, analysts,
    or infrastructure teams, Birdeye helps you ship faster with broad market
    coverage and API surfaces that support both lightweight integrations and
    data-heavy workflows.


    To start, create an account at [bds.birdeye.so](https://bds.birdeye.so),
    generate an API key from the `Security` tab, and send it in the `X-API-KEY`
    header on every request.
servers:
  - url: https://public-api.birdeye.so
security:
  - apiKeyAuth: []
tags:
  - name: Price & OHLCV
  - name: Stats
  - name: Token/Market List
  - name: Transactions
  - name: Wallet, Networth & PnL
  - name: Balance & Transfer
  - name: Holder
  - name: Alltime & History
  - name: Blockchain
  - name: Account
  - name: Token
  - name: Transaction
  - name: Creation & Trending
  - name: Meme
  - name: Security
  - name: Search & Utils
  - name: Smart Money
  - name: Global Fees Paid
  - name: DEX & Protocol
  - name: Wallet Identity
paths:
  /wallet/v2/current-net-worth:
    get:
      tags:
        - Wallet, Networth & PnL
      summary: Wallet - Portfolio (V2)
      description: >-
        Retrieve the current portfolio and total asset value on Solana or
        Robinhood. On Robinhood, price remains the market price, while value =
        amount × valuation_price. A liquidity-based portfolio guard may reduce
        valuation_price; when no adjustment applies it equals price. This is a
        valuation policy, not an executable sale quote. Staking/LP
        classification is not included in this release. Robinhood historical
        balance-change is not supported.
      operationId: get-wallet-v2-current-net-worth
      parameters:
        - $ref: '#/components/parameters/xSolanaRobinhoodChainParam'
        - $ref: '#/components/parameters/walletAddressParam'
        - $ref: '#/components/parameters/walletCurrentNetWorthFilterValueParam'
        - $ref: '#/components/parameters/currentNetworkSortByParam'
        - $ref: '#/components/parameters/currentNetworkFlagsParam'
        - $ref: '#/components/parameters/sortTypeParam'
        - $ref: '#/components/parameters/limit100Default20Param'
        - $ref: '#/components/parameters/onlyOffset10kParam'
      responses:
        '200':
          $ref: '#/components/responses/WalletCurrentNetWorth'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
components:
  parameters:
    xSolanaRobinhoodChainParam:
      name: x-chain
      description: >-
        Solana or Robinhood. Robinhood support is limited to current-net-worth,
        V1/V2 token balance and /defi/v3/token/holder; historical balance-change
        remains Solana-only.
      in: header
      required: false
      schema:
        type: string
        enum:
          - solana
          - robinhood
        default: solana
    walletAddressParam:
      name: wallet
      description: The wallet of the account.
      in: query
      required: true
      schema:
        type: string
      examples:
        solana:
          value: eJpBLoF3bgXpzjxqJRAvMchjEo4EqdAmiQh3ASmEtZT
    walletCurrentNetWorthFilterValueParam:
      name: filter_value
      description: >-
        Minimum value threshold; returns tokens with value ≥ this (optional, no
        default).
      in: query
      schema:
        type: number
      example: '12.5'
    currentNetworkSortByParam:
      name: sort_by
      description: Specify the sort field.
      in: query
      required: false
      schema:
        type: string
        enum:
          - value
        default: value
    currentNetworkFlagsParam:
      name: flags
      in: query
      description: >-
        Modifiers that change result behavior (default: empty; excludes
        low-liquidity tokens < $100, use include_low_liquidity to include them).
      required: false
      style: form
      explode: true
      schema:
        type: array
        items:
          type: string
          enum:
            - include_low_liquidity
        example:
          - include_low_liquidity
    sortTypeParam:
      name: sort_type
      description: Specify the sort order.
      in: query
      required: true
      schema:
        type: string
        enum:
          - desc
          - asc
        default: desc
    limit100Default20Param:
      name: limit
      in: query
      required: false
      schema:
        type: integer
        default: 20
        minimum: 1
        maximum: 100
    onlyOffset10kParam:
      name: offset
      description: Make sure offset <= 10000
      in: query
      required: false
      schema:
        type: integer
        default: 0
        minimum: 0
        maximum: 10000
  responses:
    '400':
      description: Bad Request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: Bad request
    '401':
      description: Unauthorized. API key is missing or invalid
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: Unauthorized
    '403':
      description: Forbidden. Request is blacklisted or not whitelisted
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: Access Denied
    '429':
      description: Too Many Requests. Rate limit reached
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: Too many requests
    '500':
      description: Internal Server Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: Internal Server Error
    WalletCurrentNetWorth:
      description: JSON object containing portfolio of an address
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/WalletCurrentNetWorthResponseSchema'
          examples:
            Robinhood:
              summary: >-
                Illustrative two-token portfolio with one adjusted and one
                unadjusted holding
              value:
                success: true
                data:
                  wallet: '0x63C12667638f2Ae6fC6ae09B43D98Ec84a8586eA'
                  currency: usd
                  total_value: '2263'
                  current_timestamp: '2026-10-05T06:00:00Z'
                  items:
                    - address: '0xb773ec2c326b7f98a5a83fc098825492f020a4c7'
                      decimals: 9
                      balance: '10000000000'
                      amount: 10
                      price: 500
                      valuation_price: 200
                      value: '2000'
                      network: robinhood
                      name: Staked NET
                      symbol: SNET
                      logo_uri: ''
                    - address: '0x08E91b659a545Bfb52F1a5e588Bf6Dc2FA85DE7A'
                      decimals: 18
                      balance: '1000000000000000000'
                      amount: 1
                      price: 263
                      valuation_price: 263
                      value: '263'
                      network: robinhood
                      name: McDonald's • Robinhood Token
                      symbol: MCD
                      logo_uri: ''
                pagination:
                  limit: 20
                  offset: 0
                  total: 2
            Solana:
              value:
                success: true
                data:
                  wallet_address: 8X35rQUK2u9hfn8rMPwwr6ZSEUhbmfDPEapp589XyoM1
                  currency: usd
                  total_value: '0.010349446772590722'
                  current_timestamp: '2025-05-19T04:47:19.414327725Z'
                  items:
                    - address: cCpv5Z3nqKbKohYqgY7rxFebjMjvU7SBhwgYbCipump
                      decimals: 6
                      price: 0.00014999198221145974
                      balance: '69000000'
                      amount: 69
                      network: solana
                      name: Smellow
                      symbol: SMLO
                      logo_uri: >-
                        https://pump.mypinata.cloud/ipfs/QmcCjKS4MMeji11PqnNhqDSXd6gD4iGj1nC6zjyfaekuQZ
                      value: '0.010349446772590722'
                pagination:
                  limit: 100
                  offset: 0
                  total: 1
  schemas:
    WalletCurrentNetWorthResponseSchema:
      type: object
      required:
        - success
        - data
      properties:
        success:
          type: boolean
          description: Whether the request succeeded.
        data:
          type: object
          properties:
            wallet_address:
              type: string
              description: Wallet address whose net worth was calculated.
            wallet:
              type: string
              description: Wallet address in the Robinhood response.
            currency:
              type: string
              description: Display currency used for valuation.
            total_value:
              type:
                - number
                - string
              description: Current total net worth in the selected currency.
            current_timestamp:
              type: string
              description: Timestamp when the valuation snapshot was computed.
            items:
              type: array
              description: Assets contributing to the current net-worth snapshot.
              items:
                $ref: '#/components/schemas/WalletTokenHolding'
        pagination:
          type: object
          properties:
            limit:
              type: integer
              description: Requested page size.
            offset:
              type: integer
              description: Requested pagination offset.
            total:
              type: integer
              description: Total number of available asset rows.
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
    WalletTokenHolding:
      type: object
      additionalProperties: true
      properties:
        address:
          type: string
          description: Token mint or contract address.
        decimals:
          type: integer
          description: Number of token decimals.
        balance:
          type:
            - number
            - string
          description: >-
            Raw token balance before decimal scaling. Robinhood returns a
            decimal string to preserve UInt256 precision.
        uiAmount:
          type: number
          description: Human-readable token amount after decimals are applied.
        chainId:
          type: string
          description: Network identifier for the token balance.
        network:
          type: string
          description: Network name when the response uses `network` instead of `chainId`.
        name:
          type: string
          description: Token display name.
        symbol:
          type: string
          description: Token symbol.
        icon:
          type: string
          description: Icon URL for the token when returned.
        logoURI:
          type: string
          description: Logo URL for the token when using camelCase fields.
        logo_uri:
          type: string
          description: Logo URL for the token when using snake_case fields.
        priceUsd:
          type:
            - number
            - 'null'
          description: >-
            Market price in USD. Robinhood V1 may return null when price
            enrichment is unavailable; an actual zero remains 0.
        price:
          type: number
          description: Latest token price in USD when the response uses `price`.
        valuation_price:
          type:
            - number
            - 'null'
          description: >-
            Robinhood effective per-unit price used for portfolio valuation.
            value = amount × valuation_price (V1: valueUsd = uiAmount ×
            valuation_price). It equals the market price when unadjusted and may
            be lower under a liquidity guard. It is position-dependent, not a
            market/sell quote. V1 may return null without price enrichment;
            actual zero price returns 0.
        valueUsd:
          type:
            - number
            - 'null'
          description: >-
            Current USD portfolio value. On Robinhood V1, uiAmount ×
            valuation_price; may be null when price enrichment is unavailable.
        value:
          type:
            - number
            - string
          description: >-
            Current USD portfolio value when using `value`. On Robinhood, amount
            × valuation_price; not necessarily amount × market price.
        amount:
          type: number
          description: Human-readable token amount when the response uses `amount`.
        isScaledUiToken:
          type: boolean
          description: Whether the token uses Solana Token-2022 scaled UI amounts.
        multiplier:
          type:
            - number
            - 'null'
          description: Scaled UI multiplier for Token-2022 assets when available.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
      description: API key for authentication

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.