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

> Returns the cryptocurrency settlement addresses (wallets) associated with the user's account. These addresses allow receiving deposits in cryptocurrencies like USDT, USDC, BTC, ETH on different blockchain networks. You can filter by specific currency and network.



## OpenAPI

````yaml GET /api/public/v1/wallets
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/wallets:
    get:
      tags:
        - Wallets
      summary: Get wallet addresses
      description: >-
        Returns the cryptocurrency settlement addresses (wallets) associated
        with the user's account. These addresses allow receiving deposits in
        cryptocurrencies like USDT, USDC, BTC, ETH on different blockchain
        networks. You can filter by specific currency and network.
      operationId: getWallets
      parameters:
        - name: currency
          in: query
          description: Filter by specific currency
          schema:
            type: string
            enum:
              - USDT
              - USDC
            example: USDT
        - name: network
          in: query
          description: Filter by specific blockchain network
          schema:
            type: string
            enum:
              - ethereum
              - arbitrum
              - solana
              - polygon
              - tron
            example: ethereum
      responses:
        '200':
          description: Wallets retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Wallet'
              examples:
                multiple-wallets:
                  summary: Multiple wallets
                  value:
                    data:
                      - address: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb'
                        network: ethereum
                        currency_code: USDT
                      - address: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb'
                        network: ethereum
                        currency_code: USDC
                empty:
                  summary: No wallets
                  value:
                    data: []
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          description: Validation error or account not verified
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                message: Your checking account is not active or verified
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
        - apiKey: []
components:
  schemas:
    Wallet:
      type: object
      properties:
        address:
          type: string
          description: Wallet address
          example: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb'
        network:
          type: string
          description: Blockchain network
          example: ethereum
        currency_code:
          type: string
          description: Currency code
          example: USDT
    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.

````