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

# Fetch Wallet Addresses

> Retrieve all wallet addressess.



## OpenAPI

````yaml /api-reference/openapi.json get /trades/wallets
openapi: 3.0.0
info:
  title: BREET PUBLIC API
  version: 1.0.0
  license:
    name: Proprietary
    url: https://breet.io/terms
servers:
  - url: https://api.breet.io/v1
security:
  - appId: []
    appSecret: []
    breetEnv: []
tags:
  - name: Crypto Wallet
    description: Generate and manage crypto wallet addresses for receiving deposits.
    x-group: Wallets and Deposits
  - name: Withdrawals
    description: >-
      ## Withdrawals


      To help protect your funds, withdrawals support an additional security
      layer through **IP whitelisting**.


      ### IP Whitelisting


      When IP whitelisting is enabled, all withdrawal requests must originate
      from an approved IP address. Any withdrawal request coming from an IP not
      on the whitelist will be automatically blocked.


      You can add up to **7 IP addresses** from your dashboard.


      This feature is recommended for:


      - Production servers
          
      - Preventing unauthorized withdrawal attempts
          

      ### How it works


      - Enable IP whitelisting from your dashboard
          
      - Add up to 7 trusted IP addresses
          
      - Only requests from those IPs will be allowed to initiate withdrawals
          

      If IP whitelisting is disabled, withdrawals can be initiated from any IP
      address.
  - name: Banks
    description: List, validate, add, and remove bank accounts for fiat withdrawals.
  - name: Transactions
    description: Retrieve deposit and trade transaction history.
  - name: Webhooks
    description: >-
      Inspect and retry **outgoing** webhooks we send to your server (trade and
      withdrawal events). Requires an active integration with API access (VIP
      partners). For **incoming** payload shapes and verification, see the
      Webhooks guide in the Guides tab.
  - name: Assets
    description: >-
      Retrieve the list of supported deposit/sell assets and their
      configuration.
  - name: Rates and Prices
    description: >-
      Get live market prices and calculate conversion rates. These endpoints are
      public and do not require authentication.
  - name: Account
    description: Retrieve and update integration account details and preferences.
  - name: Testing
    description: Endpoints for testing your integration in development.
  - name: Conversion
    description: >-
      Convert between USD and local fiat (NGN | GHS). Available for both user
      and integration (business) flows.
  - name: Wallet addresses
    description: >-
      Add and remove withdrawal (payout) wallet addresses. If the same address,
      network, and token are sent with a different label, the existing address
      is updated.
paths:
  /trades/wallets:
    get:
      tags:
        - Crypto Wallet
      summary: Fetch Wallet Addresses
      description: Retrieve all wallet addressess.
      operationId: fetchWallets
      parameters:
        - name: size
          in: query
          schema:
            type: integer
          example: 10
          description: Number of items per page
        - name: page
          in: query
          schema:
            type: integer
          example: 1
          description: Page number (1-indexed)
      responses:
        '200':
          description: List of wallet addresses returned successfully
          content:
            application/json:
              example:
                message: wallets retrieved successfully
                success: true
                data:
                  - id: 696a5f2fa6bec4ab8a8d86f8
                    avatar: https://assets.breet.io/dev/sell/assets/TRX_TEST.png
                    qr: >-
                      https://assets.breet.io/dev/assets/wallets/addresses/XYUnIx-_BewgXPmt.png
                    name: Tron Test
                    label: Partner_B-LBNS1M85_wallet-with-bank-acct
                    address: TBgs6AMzFx24DSFoyS9KuA7c9pbxax83NA
                    identifier: TRX_TEST
                    asset: 67063f653b4a1f6c7a60ec58
                    currency: ngn
                    vaultId: '136'
                    type: crypto
                    isAccountBased: true
                    isActive: true
                    bank: 696a5f35dd13b3647ce277db
                    createdAt: '2026-01-16T15:54:26.347Z'
                    updatedAt: '2026-01-16T15:54:30.229Z'
                  - id: 696a550aa6bec4ab8a8d86f7
                    avatar: https://assets.breet.io/dev/sell/assets/TRX_TEST.png
                    qr: >-
                      https://assets.breet.io/dev/assets/wallets/addresses/goqssIJYX5MxZQVS.png
                    name: Tron Test
                    label: Partner_B-LBNS1M85_wallet-with-bank
                    address: TLrEtkv2ZCEpJu1SfaDamkqWpEd945qtdG
                    identifier: TRX_TEST
                    asset: 67063f653b4a1f6c7a60ec58
                    currency: ngn
                    vaultId: '135'
                    type: crypto
                    isAccountBased: true
                    isActive: true
                    createdAt: '2026-01-16T15:11:09.337Z'
                    updatedAt: '2026-01-16T15:11:11.506Z'
                  - id: 69409efd2d7f71b18f3b9309
                    avatar: https://assets.breet.io/dev/sell/assets/TRX_TEST.png
                    qr: >-
                      https://assets.breet.io/dev/assets/wallets/addresses/HIL2BjF2OuOBYNMI.png
                    name: Tron Test
                    label: Partner_B-LBNS1M85_your-unique-wallet-label
                    address: TFm4QLi8XFoimC3kzeJ2ML1FKWXRWQXCLE
                    identifier: TRX_TEST
                    asset: 67063f653b4a1f6c7a60ec58
                    currency: ngn
                    vaultId: '128'
                    type: crypto
                    isAccountBased: true
                    isActive: true
                    createdAt: '2025-12-15T23:51:26.854Z'
                    updatedAt: '2025-12-15T23:51:27.036Z'
                  - id: 6932ea29e6ebec796ff20058
                    avatar: https://assets.breet.io/dev/sell/assets/TRX_TEST.png
                    qr: >-
                      https://assets.breet.io/dev/assets/wallets/addresses/QFxar5R09MTJKYoa.png
                    name: Tron Test
                    label: Partner_B-LBNS1M85_your-wallet-label-5
                    address: TSPAbW2UyiU9uoheDkJcSmRU5Sjt3NKK48
                    identifier: TRX_TEST
                    asset: 67063f653b4a1f6c7a60ec58
                    currency: ngn
                    vaultId: '124'
                    type: crypto
                    isAccountBased: true
                    isActive: true
                    createdAt: '2025-12-05T14:20:28.532Z'
                    updatedAt: '2025-12-05T14:20:30.216Z'
                  - id: 6932dc98c2ceccdea367388a
                    avatar: https://assets.breet.io/dev/sell/assets/TRX_TEST.png
                    name: Tron Test
                    label: Partner_B-LBNS1M85_your-wallet-label2
                    address: TV8dNYYBgL3xLbQcJLMBNavY4gYNqPF8Jv
                    identifier: TRX_TEST
                    asset: 67063f653b4a1f6c7a60ec58
                    currency: ngn
                    vaultId: '123'
                    type: crypto
                    isAccountBased: true
                    isActive: true
                    createdAt: '2025-12-05T13:22:36.095Z'
                    updatedAt: '2025-12-05T13:22:36.095Z'
                  - id: 6932d1d8728a724f1d759f01
                    avatar: https://assets.breet.io/dev/sell/assets/TRX_TEST.png
                    name: Tron Test
                    label: Partner_B-LBNS1M85_your-wallet-label
                    address: TMf7Gf7BxhAtBx5SA4Vej1wUwD4kq4CzW2
                    identifier: TRX_TEST
                    asset: 67063f653b4a1f6c7a60ec58
                    currency: ngn
                    vaultId: '122'
                    type: crypto
                    isAccountBased: true
                    isActive: true
                    createdAt: '2025-12-05T12:36:44.344Z'
                    updatedAt: '2025-12-05T12:36:44.344Z'
                  - id: 692ee010676df23be435e2f1
                    avatar: https://assets.breet.io/dev/sell/assets/SOL_TEST.png
                    qr: >-
                      https://assets.breet.io/dev/assets/wallets/addresses/-wvn7CSBFwP3ZfBf.png
                    name: Solana Test
                    label: Partner_B-LBNS1M85_test-user
                    address: 6DKYpZfd86BUDTjPe4E3JEGwnYW99KU3NDazk7BjpN8V
                    identifier: SOL_TEST
                    asset: 67063f653b4a1f6c7a60ec57
                    currency: ngn
                    vaultId: '121'
                    type: crypto
                    isAccountBased: true
                    isActive: true
                    createdAt: '2025-12-02T12:48:21.410Z'
                    updatedAt: '2025-12-02T12:48:27.279Z'
                meta:
                  pages: 1
                  prevPage: null
                  nextPage: null
                  page: 1
                  totalDocs: 7
                  hasPrevPage: false
                  hasNextPage: false
                summary: {}
                stats: {}
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  responses:
    Unauthorized:
      description: Invalid or missing API credentials
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            notAuthenticated:
              summary: Missing credentials
              value:
                success: false
                message: you're not authenticated
                meta: {}
                errors: []
                data: {}
            wrongCredentials:
              summary: Invalid app ID or secret
              value:
                success: false
                message: wrong app id and secret combination
                meta: {}
                errors: []
                data: {}
    Forbidden:
      description: The integration is inactive or the action is not permitted
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: you do not have api access
            meta: {}
            errors: []
            data: {}
    InternalServerError:
      description: An unexpected server error occurred
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: something went wrong!
            meta: {}
            errors: []
            data: {}
  schemas:
    ErrorResponse:
      type: object
      required:
        - success
        - message
      properties:
        success:
          type: boolean
          enum:
            - false
        message:
          type: string
        meta:
          type: object
        errors:
          type: array
          items:
            type: object
        data:
          type: object
  securitySchemes:
    appId:
      type: apiKey
      in: header
      name: x-app-id
      description: Your application ID from the Breet dashboard
    appSecret:
      type: apiKey
      in: header
      name: x-app-secret
      description: Your application secret from the Breet dashboard
    breetEnv:
      type: apiKey
      in: header
      name: X-Breet-Env
      description: 'Environment selector: development or production'

````