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

# Get Stocks Portfolio

> Returns the list of assets (stocks) that the user holds in their investment account, including the number of shares for each position and the available USD balance in the investment account. Only assets with a positive balance are returned.



## OpenAPI

````yaml GET /api/public/v1/balance/stocks
openapi: 3.0.3
info:
  title: Wallbit Public API
  description: >-
    Wallbit Public API allows developers to integrate Wallbit functionality into
    their applications. Access account balances, view transaction history, and
    execute trades programmatically using API Keys.
  version: 1.0.0
  contact:
    name: Wallbit API Support
    email: dev@wallbit.io
servers:
  - url: https://api.wallbit.io
    description: Production server
  - url: http://localhost
    description: Local development server
security:
  - apiKey: []
tags:
  - name: Balance
    description: Endpoints to retrieve account balances
  - name: Transactions
    description: Endpoints to retrieve transaction history
  - name: Trades
    description: Endpoints to execute trading operations
  - name: Fees
    description: >-
      Endpoints to retrieve fee configuration for the authenticated user (e.g.
      stock trading fees by subscription tier)
  - name: Account Details
    description: Endpoints to obtain bank account details
  - name: Wallets
    description: Endpoints to obtain wallet addresses
  - name: Rates
    description: Endpoints to retrieve fiat exchange rates from Wallbit
  - name: Assets
    description: Endpoints to query information about assets (stocks) and categories
  - name: Operations
    description: Endpoints for deposit and withdrawal investment operations
  - name: Cards
    description: Endpoints to block and unblock cards
  - name: API Key
    description: Endpoints to revoke the API key used for authentication
paths:
  /api/public/v1/balance/stocks:
    get:
      tags:
        - Balance
      summary: Get investment portfolio (stocks)
      description: >-
        Returns the list of assets (stocks) that the user holds in their
        investment account, including the number of shares for each position and
        the available USD balance in the investment account. Only assets with a
        positive balance are returned.
      operationId: getStocksBalance
      responses:
        '200':
          description: Portfolio with assets
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/StockBalance'
              examples:
                portfolio:
                  summary: Portfolio with multiple assets
                  value:
                    data:
                      - symbol: AAPL
                        shares: 10.5
                      - symbol: TSLA
                        shares: 5.25
                      - symbol: USD
                        shares: 500
                empty:
                  summary: Empty portfolio
                  value:
                    data: []
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
        - apiKey: []
components:
  schemas:
    StockBalance:
      type: object
      properties:
        symbol:
          type: string
          description: Asset symbol
          example: AAPL
        shares:
          type: number
          format: float
          description: Number of shares owned
          example: 10.5
    Error:
      type: object
      properties:
        message:
          type: string
          description: Error message
        error:
          type: string
          description: Error description
  responses:
    Unauthorized:
      description: Missing or invalid API Key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            missing:
              summary: Missing API Key
              value:
                message: API Key required. Please provide X-API-Key header.
            invalid:
              summary: Invalid API Key
              value:
                message: Invalid or expired API Key.
    Forbidden:
      description: Insufficient permissions
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
              your_permissions:
                type: array
                items:
                  type: string
          example:
            message: 'Insufficient permissions. Required permission: read'
            your_permissions:
              - trade
    TooManyRequests:
      description: Rate limit exceeded
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
              retry_after:
                type: integer
                description: Seconds until rate limit resets
          example:
            message: Too many requests. Please try again later.
            retry_after: 42
      headers:
        X-RateLimit-Limit:
          description: Total requests allowed per minute
          schema:
            type: integer
        X-RateLimit-Remaining:
          description: Requests remaining in current window
          schema:
            type: integer
        X-RateLimit-Reset:
          description: Unix timestamp when rate limit resets
          schema:
            type: integer
        Retry-After:
          description: Seconds to wait before retry
          schema:
            type: integer
  securitySchemes:
    apiKey:
      type: apiKey
      name: X-API-Key
      in: header
      description: >-
        API Key authentication. Obtain your API key from the Wallbit dashboard
        under Settings → API Keys.

````