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

# Child Address Update

> This endpoint is used to update a virtual account status within a specific child address.

**Auto-Funding Behavior:**

- Active accounts: Payments received trigger automatic cNGN minting
- Inactive accounts: Payments are received but auto-funding is disabled

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| isActive | boolean | Yes | true to activate, false to deactivate |



## OpenAPI

````yaml patch /v1/wallets/{walletId}/addresses/{addressId}/virtual-accounts/{virtualAccountId}
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}/addresses/{addressId}/virtual-accounts/{virtualAccountId}:
    parameters:
      - name: walletId
        in: path
        required: true
        schema:
          type: string
          example: YOUR_WALLET_ID
      - name: addressId
        in: path
        required: true
        schema:
          type: string
          example: ADDRESS_ID
      - name: virtualAccountId
        in: path
        required: true
        schema:
          type: string
          example: VIRTUAL_ACCOUNT_ID
    patch:
      tags:
        - Virtual Accounts
      summary: Child Address Update
      description: >-
        This endpoint is used to update a virtual account status within a
        specific child address.


        **Auto-Funding Behavior:**


        - Active accounts: Payments received trigger automatic cNGN minting

        - Inactive accounts: Payments are received but auto-funding is disabled


        | Field | Type | Required | Description |

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

        | isActive | boolean | Yes | true to activate, false to deactivate |
      operationId: childAddressUpdate
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                accountName:
                  type: string
                  example: Luthfulahi Oseni Olaitan
                accountNumber:
                  type: string
                  example: O157014962
            examples:
              Child Address Update:
                value:
                  accountName: Luthfulahi Oseni Olaitan
                  accountNumber: O157014962
      responses:
        '200':
          description: '200'
          headers:
            Access-Control-Allow-Origin:
              schema:
                type: string
                example: '*'
            Connection:
              schema:
                type: string
                example: keep-alive
            Content-Encoding:
              schema:
                type: string
                example: gzip
            Content-Security-Policy:
              schema:
                type: string
                example: >-
                  default-src 'self';base-uri 'self';font-src 'self' https:
                  data:;form-action 'self';frame-ancestors 'self';img-src 'self'
                  data:;object-src 'none';script-src 'self';script-src-attr
                  'none';style-src 'self' https:
                  'unsafe-inline';upgrade-insecure-requests
            Cross-Origin-Embedder-Policy:
              schema:
                type: string
                example: require-corp
            Cross-Origin-Opener-Policy:
              schema:
                type: string
                example: same-origin
            Cross-Origin-Resource-Policy:
              schema:
                type: string
                example: same-origin
            Date:
              schema:
                type: string
                example: Tue, 21 Oct 2025 03:47:00 GMT
            ETag:
              schema:
                type: string
                example: W/"41a-IqOv4kdMxK1dAI+mEbjPkF3OV0w"
            Keep-Alive:
              schema:
                type: string
                example: timeout=5
            Origin-Agent-Cluster:
              schema:
                type: string
                example: '?1'
            Referrer-Policy:
              schema:
                type: string
                example: no-referrer
            Strict-Transport-Security:
              schema:
                type: string
                example: max-age=15552000; includeSubDomains
            Transfer-Encoding:
              schema:
                type: string
                example: chunked
            Vary:
              schema:
                type: string
                example: Accept-Encoding
            X-Content-Type-Options:
              schema:
                type: string
                example: nosniff
            X-DNS-Prefetch-Control:
              schema:
                type: string
                example: 'off'
            X-Download-Options:
              schema:
                type: string
                example: noopen
            X-Frame-Options:
              schema:
                type: string
                example: SAMEORIGIN
            X-Permitted-Cross-Domain-Policies:
              schema:
                type: string
                example: none
            X-RateLimit-Limit:
              schema:
                type: string
                example: '60'
            X-RateLimit-Remaining:
              schema:
                type: string
                example: '58'
            X-RateLimit-Reset:
              schema:
                type: string
                example: '52'
            X-XSS-Protection:
              schema:
                type: string
                example: '0'
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      accountName:
                        type: string
                        example: gidin nnalu
                      accountNumber:
                        type: string
                        example: '9019769186'
                      address:
                        type: object
                        properties:
                          address:
                            type: string
                            example: '0x622B01976019d04aA2958b3DF7494A59B28459ac'
                          configurations:
                            type: object
                            properties:
                              aml:
                                type: object
                                properties:
                                  message:
                                    type: string
                                    example: Address is not sanctioned
                                  provider:
                                    type: string
                                    example: ofac, fbi, tether, circle
                                  status:
                                    type: string
                                    example: success
                              autoSettlement:
                                type: object
                                properties:
                                  isActive:
                                    type: boolean
                                    example: false
                                  rules:
                                    type: array
                                    items: {}
                                    example: []
                              disableAutoSweep:
                                type: boolean
                                example: true
                              enableGaslessWithdraw:
                                type: boolean
                                example: true
                              showPrivateKey:
                                type: boolean
                                example: false
                          createdAt:
                            type: string
                            example: '2025-11-06T18:52:46.558Z'
                          derivationPath:
                            type: string
                            example: m/44'/60'/0'/0/52
                          id:
                            type: string
                            example: bc6549bc-c500-4372-84f2-4571d4e2caeb
                          isActive:
                            type: boolean
                            example: true
                          metadata:
                            nullable: true
                            example: null
                          name:
                            type: string
                            example: Gideon nnalue
                          network:
                            type: string
                            example: mainnet
                          type:
                            type: string
                            example: INTERNAL
                          updatedAt:
                            type: string
                            example: '2025-11-06T18:52:46.558Z'
                      bankCode:
                        type: string
                        example: '076'
                      bankName:
                        type: string
                        example: Polaris Bank
                      createdAt:
                        type: string
                        example: '2025-11-06T19:09:01.146Z'
                      currency:
                        type: string
                        example: NGN
                      customer:
                        type: object
                        properties:
                          createdAt:
                            type: string
                            example: '2025-11-06T19:09:01.146Z'
                          email:
                            type: string
                            example: emekannalue1234677@gmail.com
                          id:
                            type: string
                            example: 7c72ba3c-0596-4a36-a57b-9a9327e5f75e
                          name:
                            type: string
                            example: gidin nnalu
                          network:
                            type: string
                            example: mainnet
                          phone:
                            type: string
                            example: '+2347011064991'
                          status:
                            type: string
                            example: ACTIVE
                          updatedAt:
                            type: string
                            example: '2025-11-06T19:09:01.146Z'
                      id:
                        type: string
                        example: 35245f0d-f9dd-4bed-8de7-8d5ea4d53768
                      isActive:
                        type: boolean
                        example: false
                      reference:
                        type: string
                        example: '21'
                      status:
                        type: string
                        example: INACTIVE
                      type:
                        type: string
                        example: AUTO_FUNDING
                      updatedAt:
                        type: string
                        example: '2025-11-06T19:13:48.680Z'
                      wallet:
                        type: object
                        properties:
                          address:
                            type: string
                            example: '0xD8582C57E56Ef45f9fe82870aDF63d9baB89e1F7'
                          configurations:
                            nullable: true
                            example: null
                          createdAt:
                            type: string
                            example: '2024-05-27T19:33:42.377Z'
                          derivationPath:
                            type: string
                            example: m/44'/60'/0'/0/11
                          description:
                            type: string
                            example: This is Base wallet
                          id:
                            type: string
                            example: 35e964a6-436a-424f-bf3a-618cc060feea
                          isActive:
                            type: boolean
                            example: true
                          name:
                            type: string
                            example: Base Wallet
                          network:
                            type: string
                            example: mainnet
                          status:
                            type: string
                            example: ACTIVE
                          updatedAt:
                            type: string
                            example: '2024-05-27T19:33:42.377Z'
                  message:
                    type: string
                    example: Virtual account updated successfully
                  statusCode:
                    type: number
                    example: 200
              examples:
                '200':
                  value:
                    data:
                      accountName: gidin nnalu
                      accountNumber: '9019769186'
                      address:
                        address: '0x622B01976019d04aA2958b3DF7494A59B28459ac'
                        configurations:
                          aml:
                            message: Address is not sanctioned
                            provider: ofac, fbi, tether, circle
                            status: success
                          autoSettlement:
                            isActive: false
                            rules: []
                          disableAutoSweep: true
                          enableGaslessWithdraw: true
                          showPrivateKey: false
                        createdAt: '2025-11-06T18:52:46.558Z'
                        derivationPath: m/44'/60'/0'/0/52
                        id: bc6549bc-c500-4372-84f2-4571d4e2caeb
                        isActive: true
                        metadata: null
                        name: Gideon nnalue
                        network: mainnet
                        type: INTERNAL
                        updatedAt: '2025-11-06T18:52:46.558Z'
                      bankCode: '076'
                      bankName: Polaris Bank
                      createdAt: '2025-11-06T19:09:01.146Z'
                      currency: NGN
                      customer:
                        createdAt: '2025-11-06T19:09:01.146Z'
                        email: emekannalue1234677@gmail.com
                        id: 7c72ba3c-0596-4a36-a57b-9a9327e5f75e
                        name: gidin nnalu
                        network: mainnet
                        phone: '+2347011064991'
                        status: ACTIVE
                        updatedAt: '2025-11-06T19:09:01.146Z'
                      id: 35245f0d-f9dd-4bed-8de7-8d5ea4d53768
                      isActive: false
                      reference: '21'
                      status: INACTIVE
                      type: AUTO_FUNDING
                      updatedAt: '2025-11-06T19:13:48.680Z'
                      wallet:
                        address: '0xD8582C57E56Ef45f9fe82870aDF63d9baB89e1F7'
                        configurations: null
                        createdAt: '2024-05-27T19:33:42.377Z'
                        derivationPath: m/44'/60'/0'/0/11
                        description: This is Base wallet
                        id: 35e964a6-436a-424f-bf3a-618cc060feea
                        isActive: true
                        name: Base Wallet
                        network: mainnet
                        status: ACTIVE
                        updatedAt: '2024-05-27T19:33:42.377Z'
                    message: Virtual account updated successfully
                    statusCode: 200
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: x-api-key
      in: header

````