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

# Get Wallet

> This endpoint retrieves the details of a specific wallet

### Query Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| showPrivateKey | boolean | Optional | If `true`, the response will include the private key. If `false` or omitted, the private key is not computed. |



## OpenAPI

````yaml get /v1/wallets/{walletId}
openapi: 3.0.3
info:
  title: Blockradar Documentation
  description: >-
    The OpenAPI specification of the Blockradar API that enables fintechs and
    developers to seamlessly integrate stablecoin deposits and payments into
    their products.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.blockradar.co
security:
  - apiKey: []
tags:
  - name: Rewards
    description: >-
      Non-custodial yield (Earn) on stablecoins via regulated (Fija) and DeFi
      (Aave) strategies. Deposit, withdraw, preview fees, and read positions and
      earnings at the business, wallet, and sub-address level. Amounts are
      returned net of the platform fee, which applies only to interest earned.
  - name: Wallet
    description: >-
      Wallet Management System


      Comprehensive wallet management API for multi-blockchain operations. This
      system handles wallet creation, configuration, balance monitoring, and
      integration with various blockchain networks.


      Core Functionality:


      - Multi-blockchain wallet creation and management

      - Balance monitoring and asset tracking

      - Auto-settlement rule configuration

      - Gateway wallet integration

      - Address generation and management

      - Transaction monitoring and processing
  - name: Addresses
    description: >-
      Address Management System


      Comprehensive blockchain address management API for operations. This
      system handles address creation, validation, monitoring, and management
      across multiple blockchain networks.


      Core Functionality:


      - Multi-blockchain address generation

      - Address validation and verification

      - Balance monitoring and tracking

      - Transaction history management

      - Address labeling and organization

      - Integration with wallet systems

      - Real-time address monitoring
  - name: Asset
  - name: Transactions
  - name: Withdraw
    description: >-
      The Withdraw feature allows you to programmatically withdraw stablecoins
      from your master wallet with ease
  - name: Withdraw Fiat
  - name: Signing
    description: >-
      Typed data signing service for secure transaction authorization. Supports
      all EIP-712 standards including EIP-3009 (TransferWithAuthorization) and
      EIP-2612 (Permit).
  - name: Swap
    description: >-
      The Swap feature enables users to exchange one stabelcoin asset for
      another across different blockchains. This feature provides a seamless way
      to convert between different stablecoins while maintaining security and
      compliance standards.
  - name: Liquidity Pool
  - name: Virtual Accounts
    description: >-
      Virtual Accounts API provides endpoints for managing virtual bank accounts
      linked to master wallets or child addresses. This API enables businesses
      to:


      - Create virtual accounts for customers to receive payments

      - Retrieve virtual account details

      - Activate/deactivate virtual accounts


      **Virtual Account Types:**


      Virtual accounts support different types with varying behaviors:


      1. **AUTO_FUNDING** (Default):

          - Automatically mints stablecoin when fiat payments are received

          - Transfers the stablecoin to the linked wallet/address immediately

          - Best for real-time payment processing


      **How It Works - Auto-Funding Flow (AUTO_FUNDING type only):**


      When a customer sends fiat currency to a virtual account with type
      AUTO_FUNDING:


      1. **Payment Receipt**: The payment is received in the virtual account

      2. **Automatic Minting**: The system automatically mints the stablecoin
      equivalent

      3. **Blockchain Transfer**: The minted stablecoin is transferred to the
      virtual account's linked wallet or address


      **Note**: The auto-funding flow only applies to virtual accounts with type
      `AUTO_FUNDING`.

      Other types have different processing behaviors.


      ## Prerequisites


      Before creating virtual accounts, ensure:


      - **Compliance requirements must be completed** (see [Compliance
      Requirements](http://localhost:3000/essentials/virtual-accounts#compliance-requirements)
      section below)

      - **Virtual accounts feature must be enabled** for your business (reach
      out to [support@blockradar.co](https://mailto:support@blockradar.co) or
      use live chat on the dashboard to enable the feature after compliance
      approval)

      - **Only available on MAINNET environment** (not available on testnet)

      - **Master Wallet must support stablecoin asset** - Your account plan must
      include stablecoin access (upgrade from Dashboard → Settings →
      Subscription if needed)


      **Supported Currency:**


      - Fiat: NGN (Nigerian Naira)

      - Stablecoin: cNGN - minted automatically on blockchain (for AUTO_FUNDING
      type)
  - name: Auto Settlements
    description: >-
      Creates a new auto settlement rule for a wallet. Auto settlement
      automatically transfers/swap assets based on configured rules when certain
      conditions are met.


      Rules can be configured for:


      - Source blockchain and assets

      - Destination blockchain and asset

      - Amount ranges (min/max)

      - Slippage tolerance

      - Gateway vs non-gateway wallets


      Gateway rules are required for testnet wallets and must have matching
      source/destination assets.
  - name: Smart Contract
    description: >-
      This API provides endpoints for interacting with smart contracts on the
      blockchain. It allows for reading contract data, executing contract
      functions, and estimating network fees.
  - name: Gateway
    description: >-
      The Gateway feature enables you to programmatically deposit USDC into a
      unified, chain-abstracted balance and instantly mint USDC on any supported
      blockchain, streamlining crosschain transfers and eliminating manual
      bridging steps and rebalancing complexities.
  - name: Payment Links
    description: >-
      The Payment Pages API provides a quick and secure way to collect payment
      for servcies.
  - name: Beneficiaries
    description: >-
      This API allows you to create beneficiaries with automatic settlements to
      your external wallets on a periodic basis.


      Example frequencies: INSTANT, DAILY, WEEKLY, MONTHLY, YEARLY
  - name: AML
    description: >-
      The AML (Anti Money Laundering) API provides a quick way for you to check
      if an address is blacklisted or sanctioned
  - name: Asset Recovery
    description: >-
      Enables the recovery (salvage) of both native blockchain assets and tokens
      from a specified sender address to a recipient address. This feature
      supports emergency fund recovery and asset consolidation operations.
  - name: Miscellaneous
    description: >-
      The Miscellaneous API are supporting APIs that can be used to provide more
      details to other APIs.
  - name: Asset1
  - name: Blockchain
  - name: Webhooks
    description: >-
      Webhooks allow you to set up a notification system that can be used to
      receive updates on certain requests made to the Blockradar API.

      To see full list and instructions
      [https://docs.blockradar.co/essentials/webhooks](https://docs.blockradar.co/essentials/webhooks)


      ##
  - name: Deposit
  - name: Withdraw1
  - name: Swap1
  - name: Gateway1
paths:
  /v1/wallets/{walletId}:
    parameters:
      - name: walletId
        in: path
        required: true
        schema:
          type: string
          example: YOUR_WALLET_ID
    get:
      tags:
        - Wallet
      summary: Get Wallet
      description: >-
        This endpoint retrieves the details of a specific wallet


        ### Query Parameters


        | Name | Type | Required | Description |

        | --- | --- | --- | --- |

        | showPrivateKey | boolean | Optional | If `true`, the response will
        include the private key. If `false` or omitted, the private key is not
        computed. |
      operationId: getWallet
      parameters:
        - name: showPrivateKey
          in: query
          schema:
            type: string
            example: OPTIONAL_BOOLEAN
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      address:
                        type: string
                        example: '0x947514e4B803e312C312da0F1B41fEDdbe15ae7a'
                      analytics:
                        type: object
                        properties:
                          currentBalance:
                            type: number
                            example: 58.88822990007824
                          numberOfAssets:
                            type: number
                            example: 2
                          unsweptBalance:
                            type: number
                            example: 0
                      assets:
                        type: array
                        items:
                          type: object
                          properties:
                            asset:
                              type: object
                              properties:
                                address:
                                  type: string
                                  example: '0x0000000000000000000000000000000000000000'
                                blockchain:
                                  type: object
                                  properties:
                                    createdAt:
                                      type: string
                                      example: '2024-05-14T11:53:33.106Z'
                                    derivationPath:
                                      type: string
                                      example: m/44'/60'/0'/0
                                    id:
                                      type: string
                                      example: b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa
                                    isActive:
                                      type: boolean
                                      example: true
                                    isEvmCompatible:
                                      type: boolean
                                      example: true
                                    logoUrl:
                                      type: string
                                      example: >-
                                        https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/bnb-bnb-logo_e4qdyk.png
                                    name:
                                      type: string
                                      example: BNB smart chain
                                    slug:
                                      type: string
                                      example: bnb-smart-chain
                                    symbol:
                                      type: string
                                      example: bnb
                                    tokenStandard:
                                      type: string
                                      example: BEP20
                                    updatedAt:
                                      type: string
                                      example: '2024-06-14T22:36:43.716Z'
                                createdAt:
                                  type: string
                                  example: '2024-05-14T11:53:33.678Z'
                                decimals:
                                  type: number
                                  example: 18
                                id:
                                  type: string
                                  example: ef2458b5-b292-4f5a-89c4-71c8576e6272
                                isActive:
                                  type: boolean
                                  example: true
                                logoUrl:
                                  type: string
                                  example: >-
                                    https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/bnb-bnb-logo_e4qdyk.png
                                name:
                                  type: string
                                  example: Binance Coin
                                network:
                                  type: string
                                  example: testnet
                                standard:
                                  type: string
                                  nullable: true
                                  example: null
                                symbol:
                                  type: string
                                  example: BNB
                                updatedAt:
                                  type: string
                                  example: '2024-10-27T07:52:16.162Z'
                            createdAt:
                              type: string
                              example: '2024-08-22T09:29:11.387Z'
                            id:
                              type: string
                              example: 98582300-2f1d-4ef4-99f2-4361319fc776
                            isActive:
                              type: boolean
                              example: true
                            updatedAt:
                              type: string
                              example: '2024-08-22T09:29:11.387Z'
                        example:
                          - asset:
                              address: '0x0000000000000000000000000000000000000000'
                              blockchain:
                                createdAt: '2024-05-14T11:53:33.106Z'
                                derivationPath: m/44'/60'/0'/0
                                id: b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa
                                isActive: true
                                isEvmCompatible: true
                                logoUrl: >-
                                  https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/bnb-bnb-logo_e4qdyk.png
                                name: BNB smart chain
                                slug: bnb-smart-chain
                                symbol: bnb
                                tokenStandard: BEP20
                                updatedAt: '2024-06-14T22:36:43.716Z'
                              createdAt: '2024-05-14T11:53:33.678Z'
                              decimals: 18
                              id: ef2458b5-b292-4f5a-89c4-71c8576e6272
                              isActive: true
                              logoUrl: >-
                                https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/bnb-bnb-logo_e4qdyk.png
                              name: Binance Coin
                              network: testnet
                              standard: null
                              symbol: BNB
                              updatedAt: '2024-10-27T07:52:16.162Z'
                            createdAt: '2024-08-22T09:29:11.387Z'
                            id: 98582300-2f1d-4ef4-99f2-4361319fc776
                            isActive: true
                            updatedAt: '2024-08-22T09:29:11.387Z'
                          - asset:
                              address: '0x337610d27c682E347C9cD60BD4b3b107C9d34dDd'
                              blockchain:
                                createdAt: '2024-05-14T11:53:33.106Z'
                                derivationPath: m/44'/60'/0'/0
                                id: b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa
                                isActive: true
                                isEvmCompatible: true
                                logoUrl: >-
                                  https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/bnb-bnb-logo_e4qdyk.png
                                name: BNB smart chain
                                slug: bnb-smart-chain
                                symbol: bnb
                                tokenStandard: BEP20
                                updatedAt: '2024-06-14T22:36:43.716Z'
                              createdAt: '2024-05-14T11:53:33.680Z'
                              decimals: 18
                              id: 1890db58-f624-4972-a72b-e25387a81520
                              isActive: true
                              logoUrl: >-
                                https://res.cloudinary.com/blockradar/image/upload/v1716800082/crypto-assets/tether-usdt-logo_wx7rwh.png
                              name: Tether USD
                              network: testnet
                              standard: BEP20
                              symbol: USDT
                              updatedAt: '2024-06-14T22:36:43.868Z'
                            createdAt: '2024-08-22T10:33:45.481Z'
                            id: ae455f23-3824-4125-baab-d158315cbcbd
                            isActive: true
                            updatedAt: '2024-08-22T10:33:45.481Z'
                      blockchain:
                        type: object
                        properties:
                          createdAt:
                            type: string
                            example: '2024-05-14T11:53:33.106Z'
                          derivationPath:
                            type: string
                            example: m/44'/60'/0'/0
                          id:
                            type: string
                            example: b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa
                          isActive:
                            type: boolean
                            example: true
                          isEvmCompatible:
                            type: boolean
                            example: true
                          logoUrl:
                            type: string
                            example: >-
                              https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/bnb-bnb-logo_e4qdyk.png
                          name:
                            type: string
                            example: BNB smart chain
                          slug:
                            type: string
                            example: bnb-smart-chain
                          symbol:
                            type: string
                            example: bnb
                          tokenStandard:
                            type: string
                            example: BEP20
                          updatedAt:
                            type: string
                            example: '2024-06-14T22:36:43.716Z'
                      createdAt:
                        type: string
                        example: '2024-08-22T09:29:11.387Z'
                      derivationPath:
                        type: string
                        example: m/44'/60'/0'/0/0
                      description:
                        type: string
                        example: This is BNB smart chain testnet master wallet
                      id:
                        type: string
                        example: 4465468a-3c36-4536-918a-91d689e18a74
                      isActive:
                        type: boolean
                        example: true
                      name:
                        type: string
                        example: BNB smart chain Master Wallet
                      network:
                        type: string
                        example: testnet
                      status:
                        type: string
                        example: ACTIVE
                      updatedAt:
                        type: string
                        example: '2024-10-30T07:11:56.221Z'
                  message:
                    type: string
                    example: Wallet fetched successfully
                  statusCode:
                    type: number
                    example: 200
              examples:
                '200':
                  value:
                    data:
                      address: '0x947514e4B803e312C312da0F1B41fEDdbe15ae7a'
                      analytics:
                        currentBalance: 58.88822990007824
                        numberOfAssets: 2
                        unsweptBalance: 0
                      assets:
                        - asset:
                            address: '0x0000000000000000000000000000000000000000'
                            blockchain:
                              createdAt: '2024-05-14T11:53:33.106Z'
                              derivationPath: m/44'/60'/0'/0
                              id: b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa
                              isActive: true
                              isEvmCompatible: true
                              logoUrl: >-
                                https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/bnb-bnb-logo_e4qdyk.png
                              name: BNB smart chain
                              slug: bnb-smart-chain
                              symbol: bnb
                              tokenStandard: BEP20
                              updatedAt: '2024-06-14T22:36:43.716Z'
                            createdAt: '2024-05-14T11:53:33.678Z'
                            decimals: 18
                            id: ef2458b5-b292-4f5a-89c4-71c8576e6272
                            isActive: true
                            logoUrl: >-
                              https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/bnb-bnb-logo_e4qdyk.png
                            name: Binance Coin
                            network: testnet
                            standard: null
                            symbol: BNB
                            updatedAt: '2024-10-27T07:52:16.162Z'
                          createdAt: '2024-08-22T09:29:11.387Z'
                          id: 98582300-2f1d-4ef4-99f2-4361319fc776
                          isActive: true
                          updatedAt: '2024-08-22T09:29:11.387Z'
                        - asset:
                            address: '0x337610d27c682E347C9cD60BD4b3b107C9d34dDd'
                            blockchain:
                              createdAt: '2024-05-14T11:53:33.106Z'
                              derivationPath: m/44'/60'/0'/0
                              id: b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa
                              isActive: true
                              isEvmCompatible: true
                              logoUrl: >-
                                https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/bnb-bnb-logo_e4qdyk.png
                              name: BNB smart chain
                              slug: bnb-smart-chain
                              symbol: bnb
                              tokenStandard: BEP20
                              updatedAt: '2024-06-14T22:36:43.716Z'
                            createdAt: '2024-05-14T11:53:33.680Z'
                            decimals: 18
                            id: 1890db58-f624-4972-a72b-e25387a81520
                            isActive: true
                            logoUrl: >-
                              https://res.cloudinary.com/blockradar/image/upload/v1716800082/crypto-assets/tether-usdt-logo_wx7rwh.png
                            name: Tether USD
                            network: testnet
                            standard: BEP20
                            symbol: USDT
                            updatedAt: '2024-06-14T22:36:43.868Z'
                          createdAt: '2024-08-22T10:33:45.481Z'
                          id: ae455f23-3824-4125-baab-d158315cbcbd
                          isActive: true
                          updatedAt: '2024-08-22T10:33:45.481Z'
                      blockchain:
                        createdAt: '2024-05-14T11:53:33.106Z'
                        derivationPath: m/44'/60'/0'/0
                        id: b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa
                        isActive: true
                        isEvmCompatible: true
                        logoUrl: >-
                          https://res.cloudinary.com/blockradar/image/upload/v1716800080/crypto-assets/bnb-bnb-logo_e4qdyk.png
                        name: BNB smart chain
                        slug: bnb-smart-chain
                        symbol: bnb
                        tokenStandard: BEP20
                        updatedAt: '2024-06-14T22:36:43.716Z'
                      createdAt: '2024-08-22T09:29:11.387Z'
                      derivationPath: m/44'/60'/0'/0/0
                      description: This is BNB smart chain testnet master wallet
                      id: 4465468a-3c36-4536-918a-91d689e18a74
                      isActive: true
                      name: BNB smart chain Master Wallet
                      network: testnet
                      status: ACTIVE
                      updatedAt: '2024-10-30T07:11:56.221Z'
                    message: Wallet fetched successfully
                    statusCode: 200
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: x-api-key
      in: header

````