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

> Child Address Execute



## OpenAPI

````yaml post /v1/wallets/{walletId}/addresses/{addressId}/withdraw/fiat/execute
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}/withdraw/fiat/execute:
    parameters:
      - name: walletId
        in: path
        required: true
        schema:
          type: string
          example: YOUR_WALLET_ID
      - name: addressId
        in: path
        required: true
        schema:
          type: string
          example: '0xaeAE273Cc4f8CCdF9786eb2967D5d24E8255c092'
    post:
      tags:
        - Withdraw Fiat
      summary: Child Address Execute
      description: Child Address Execute
      operationId: childAddressExecute
      requestBody:
        content:
          application/json:
            schema:
              required:
                - assetId
                - institutionIdentifier
                - accountIdentifier
                - currency
                - amount
              type: object
              properties:
                reference:
                  type: string
                  description: client reference for tracking transaction
                  example: 8034007516
                accountIdentifier:
                  description: destination bank account identifier
                  type: string
                  example: '8034007516'
                amount:
                  description: amount to withdraw in asset units
                  type: number
                  example: 0.5
                assetId:
                  description: asset ID of the stablecoin to withdraw
                  type: string
                  example: 37079b6b-b74f-48e9-a394-9a5cbae88f12
                code:
                  type: string
                  example: '956407'
                currency:
                  description: destination fiat currency code
                  type: string
                  example: NGN
                institutionIdentifier:
                  description: bank or institution identifier code
                  type: string
                  example: OPAYNGPC
            examples:
              Child Address Execute:
                value:
                  accountIdentifier: '8034007516'
                  amount: 0.5
                  assetId: 37079b6b-b74f-48e9-a394-9a5cbae88f12
                  code: '956407'
                  currency: NGN
                  institutionIdentifier: OPAYNGPC
      responses:
        '201':
          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: Sat, 24 Jan 2026 21:05:10 GMT
            ETag:
              schema:
                type: string
                example: W/"f0d-H9JOFChh8bHqA2tK585tS783IZ4"
            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: '57'
            X-RateLimit-Reset:
              schema:
                type: string
                example: '34'
            X-XSS-Protection:
              schema:
                type: string
                example: '0'
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      gateway:
                        type: string
                        example: '0x30F6A8457F8E42371E204a9c103f2Bd42341dD0F'
                      senderFee:
                        type: object
                        properties:
                          hex:
                            type: string
                            example: '0x00'
                          type:
                            type: string
                            example: BigNumber
                      senderFeeRecipient:
                        type: string
                        example: '0xaeAE273Cc4f8CCdF9786eb2967D5d24E8255c092'
                      transaction:
                        type: object
                        properties:
                          amlScreening:
                            type: object
                            properties: {}
                          amount:
                            type: string
                            example: '0.5'
                          amountPaid:
                            type: string
                            example: '0.5'
                          amountUSD:
                            type: string
                            example: '0.5'
                          asset:
                            nullable: true
                            example: null
                          assetSwept:
                            nullable: true
                            example: null
                          assetSweptAmount:
                            nullable: true
                            example: null
                          assetSweptAt:
                            nullable: true
                            example: null
                          assetSweptGasFee:
                            nullable: true
                            example: null
                          assetSweptHash:
                            nullable: true
                            example: null
                          assetSweptRecipientAddress:
                            nullable: true
                            example: null
                          assetSweptSenderAddress:
                            nullable: true
                            example: null
                          blockHash:
                            nullable: true
                            example: null
                          blockNumber:
                            nullable: true
                            example: null
                          blockchain:
                            type: object
                            properties:
                              configurations:
                                nullable: true
                                example: null
                              createdAt:
                                type: string
                                example: '2026-01-20T08:10:37.776Z'
                              derivationPath:
                                type: string
                                example: m/44'/60'/0'/0
                              id:
                                type: string
                                example: 384ba700-5831-49a1-8cba-7d89385d5a25
                              isActive:
                                type: boolean
                                example: true
                              isEvmCompatible:
                                type: boolean
                                example: true
                              isL2:
                                type: boolean
                                example: true
                              name:
                                type: string
                                example: base
                              networkFeeModel:
                                type: string
                                example: native
                              slug:
                                type: string
                                example: base
                              symbol:
                                type: string
                                example: eth
                              tokenStandard:
                                nullable: true
                                example: null
                              updatedAt:
                                type: string
                                example: '2026-01-20T08:10:37.776Z'
                          chainId:
                            nullable: true
                            example: null
                          confirmations:
                            nullable: true
                            example: null
                          confirmed:
                            type: boolean
                            example: false
                          createdAt:
                            type: string
                            example: '2026-01-24T21:05:10.778Z'
                          createdChannel:
                            type: string
                            example: dashboard
                          currency:
                            type: string
                            example: USD
                          fee:
                            type: string
                            example: '0'
                          feeHash:
                            nullable: true
                            example: null
                          feeUSD:
                            type: string
                            example: '0'
                          gasFee:
                            nullable: true
                            example: null
                          gasPrice:
                            nullable: true
                            example: null
                          gasUsed:
                            nullable: true
                            example: null
                          hash:
                            nullable: true
                            example: null
                          id:
                            type: string
                            example: f93c28b7-d8f7-43ab-9373-22a9a8931177
                          isAutoSweep:
                            type: boolean
                            example: false
                          metadata:
                            type: object
                            properties:
                              businessId:
                                type: string
                                example: 6271be9f-b48a-4e6d-b14b-b76629bc7014
                              businessProviderId:
                                type: string
                                example: 1c40879e-c340-4308-92d9-30bdb34b3b84
                          network:
                            type: string
                            example: mainnet
                          note:
                            type: string
                            example: >-
                              Method: createOrder | Contract Address:
                              0x30F6A8457F8E42371E204a9c103f2Bd42341dD0F
                          processingReason:
                            nullable: true
                            example: null
                          processingStatus:
                            type: string
                            example: PENDING
                          rate:
                            type: string
                            example: '1465.14'
                          rateUSD:
                            type: string
                            example: '1'
                          reason:
                            type: string
                            example: >-
                              {"method":"createOrder","parameters":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",{"type":"BigNumber","hex":"0x07a120"},{"type":"BigNumber","hex":"0x023c52"},"0xaeAE273Cc4f8CCdF9786eb2967D5d24E8255c092",{"type":"BigNumber","hex":"0x00"},"0xaeAE273Cc4f8CCdF9786eb2967D5d24E8255c092","HblZl+1ItFI/v98ewxY6gq/d+9KqzfjDHGKva2r4KzKFqE19Q+1+IA7w2PE0yKJxB26jNjXYCN32IAnH129K232soxCPXVYRRX+jSps9yOtwUUi0ZPRfInqJXKubGXOJPiQnr9bg81fAkr2+DY9oMMB1u0gzDptBkq3FykFqMYMeXVeyepE0IO2ZJLa7Jk5BtgBP7iQwj7W+PknC8/0rvIz6czDgzFpssTb5QYGR/nPlEUWgHmu5DUD+22wxd/xA/Cm8Y7DWHMCRvNG+0FpVLa2OlPK4f4dI0hKZsuG5iaEl6/ucgHvupl3fAHISnwOqZgM5RvxF8iM5XKvBJkEyZg=="],"abi":{"inputs":[{"internalType":"address","name":"_token","type":"address"},{"internalType":"uint256","name":"_amount","type":"uint256"},{"internalType":"uint96","name":"_rate","type":"uint96"},{"internalType":"address","name":"_senderFeeRecipient","type":"address"},{"internalType":"uint256","name":"_senderFee","type":"uint256"},{"internalType":"address","name":"_refundAddress","type":"address"},{"internalType":"string","name":"messageHash","type":"string"}],"name":"createOrder","outputs":[{"internalType":"bytes32","name":"orderId","type":"bytes32"}],"stateMutability":"nonpayable","type":"function"}}
                          recipientAddress:
                            type: string
                            example: '0x30F6A8457F8E42371E204a9c103f2Bd42341dD0F'
                          reference:
                            type: string
                            example: Cy1NqiVNDw7Ajsj1yECX
                          senderAddress:
                            type: string
                            example: '0xaeAE273Cc4f8CCdF9786eb2967D5d24E8255c092'
                          signedTransaction:
                            nullable: true
                            example: null
                          status:
                            type: string
                            example: PENDING
                          toAmount:
                            type: string
                            example: '732570000'
                          toCurrency:
                            nullable: true
                            example: null
                          tokenAddress:
                            type: string
                            example: '0x30F6A8457F8E42371E204a9c103f2Bd42341dD0F'
                          type:
                            type: string
                            example: OFFRAMP
                          updatedAt:
                            type: string
                            example: '2026-01-24T21:05:10.778Z'
                          wallet:
                            type: object
                            properties:
                              address:
                                type: string
                                example: '0x969838345E5cd5F755DfcADB57e72F5d23271e48'
                              configurations:
                                type: object
                                properties:
                                  addresses:
                                    type: object
                                    properties:
                                      prefunding:
                                        type: object
                                        properties:
                                          isActive:
                                            type: boolean
                                            example: false
                                          rules:
                                            type: array
                                            items: {}
                                            example: []
                                  autoSettlement:
                                    type: object
                                    properties:
                                      isActive:
                                        type: boolean
                                        example: false
                                      rules:
                                        type: array
                                        items: {}
                                        example: []
                                  autoSweeping:
                                    type: object
                                    properties:
                                      isActive:
                                        type: boolean
                                        example: true
                                      threshold:
                                        type: number
                                        example: 0
                                  withdrawal:
                                    type: object
                                    properties:
                                      gasless:
                                        type: object
                                        properties:
                                          isActive:
                                            type: boolean
                                            example: false
                                          operator:
                                            type: string
                                            example: gt
                                          threshold:
                                            type: number
                                            example: 0
                              createdAt:
                                type: string
                                example: '2026-01-20T08:44:44.305Z'
                              derivationPath:
                                type: string
                                example: m/44'/60'/0'/0/0
                              description:
                                type: string
                                example: This is Base master Wallet
                              id:
                                type: string
                                example: 7aa5120b-2106-43c6-92c7-6458b7d2de8b
                              isActive:
                                type: boolean
                                example: true
                              name:
                                type: string
                                example: Base Mainnet
                              network:
                                type: string
                                example: mainnet
                              status:
                                type: string
                                example: ACTIVE
                              updatedAt:
                                type: string
                                example: '2026-01-20T08:44:44.305Z'
                  message:
                    type: string
                    example: Withdraw fiat execution initiated
                  statusCode:
                    type: number
                    example: 200
              examples:
                '200':
                  value:
                    reference: '8034007516'
                    data:
                      gateway: '0x30F6A8457F8E42371E204a9c103f2Bd42341dD0F'
                      senderFee:
                        hex: '0x00'
                        type: BigNumber
                      senderFeeRecipient: '0xaeAE273Cc4f8CCdF9786eb2967D5d24E8255c092'
                      transaction:
                        amlScreening: {}
                        amount: '0.5'
                        amountPaid: '0.5'
                        amountUSD: '0.5'
                        asset: null
                        assetSwept: null
                        assetSweptAmount: null
                        assetSweptAt: null
                        assetSweptGasFee: null
                        assetSweptHash: null
                        assetSweptRecipientAddress: null
                        assetSweptSenderAddress: null
                        blockHash: null
                        blockNumber: null
                        blockchain:
                          configurations: null
                          createdAt: '2026-01-20T08:10:37.776Z'
                          derivationPath: m/44'/60'/0'/0
                          id: 384ba700-5831-49a1-8cba-7d89385d5a25
                          isActive: true
                          isEvmCompatible: true
                          isL2: true
                          name: base
                          networkFeeModel: native
                          slug: base
                          symbol: eth
                          tokenStandard: null
                          updatedAt: '2026-01-20T08:10:37.776Z'
                        chainId: null
                        confirmations: null
                        confirmed: false
                        createdAt: '2026-01-24T21:05:10.778Z'
                        createdChannel: dashboard
                        currency: USD
                        fee: '0'
                        feeHash: null
                        feeUSD: '0'
                        gasFee: null
                        gasPrice: null
                        gasUsed: null
                        hash: null
                        id: f93c28b7-d8f7-43ab-9373-22a9a8931177
                        isAutoSweep: false
                        metadata:
                          businessId: 6271be9f-b48a-4e6d-b14b-b76629bc7014
                          businessProviderId: 1c40879e-c340-4308-92d9-30bdb34b3b84
                        network: mainnet
                        note: >-
                          Method: createOrder | Contract Address:
                          0x30F6A8457F8E42371E204a9c103f2Bd42341dD0F
                        processingReason: null
                        processingStatus: PENDING
                        rate: '1465.14'
                        rateUSD: '1'
                        reason: >-
                          {"method":"createOrder","parameters":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",{"type":"BigNumber","hex":"0x07a120"},{"type":"BigNumber","hex":"0x023c52"},"0xaeAE273Cc4f8CCdF9786eb2967D5d24E8255c092",{"type":"BigNumber","hex":"0x00"},"0xaeAE273Cc4f8CCdF9786eb2967D5d24E8255c092","HblZl+1ItFI/v98ewxY6gq/d+9KqzfjDHGKva2r4KzKFqE19Q+1+IA7w2PE0yKJxB26jNjXYCN32IAnH129K232soxCPXVYRRX+jSps9yOtwUUi0ZPRfInqJXKubGXOJPiQnr9bg81fAkr2+DY9oMMB1u0gzDptBkq3FykFqMYMeXVeyepE0IO2ZJLa7Jk5BtgBP7iQwj7W+PknC8/0rvIz6czDgzFpssTb5QYGR/nPlEUWgHmu5DUD+22wxd/xA/Cm8Y7DWHMCRvNG+0FpVLa2OlPK4f4dI0hKZsuG5iaEl6/ucgHvupl3fAHISnwOqZgM5RvxF8iM5XKvBJkEyZg=="],"abi":{"inputs":[{"internalType":"address","name":"_token","type":"address"},{"internalType":"uint256","name":"_amount","type":"uint256"},{"internalType":"uint96","name":"_rate","type":"uint96"},{"internalType":"address","name":"_senderFeeRecipient","type":"address"},{"internalType":"uint256","name":"_senderFee","type":"uint256"},{"internalType":"address","name":"_refundAddress","type":"address"},{"internalType":"string","name":"messageHash","type":"string"}],"name":"createOrder","outputs":[{"internalType":"bytes32","name":"orderId","type":"bytes32"}],"stateMutability":"nonpayable","type":"function"}}
                        recipientAddress: '0x30F6A8457F8E42371E204a9c103f2Bd42341dD0F'
                        reference: Cy1NqiVNDw7Ajsj1yECX
                        senderAddress: '0xaeAE273Cc4f8CCdF9786eb2967D5d24E8255c092'
                        signedTransaction: null
                        status: PENDING
                        toAmount: '732570000'
                        toCurrency: null
                        tokenAddress: '0x30F6A8457F8E42371E204a9c103f2Bd42341dD0F'
                        type: OFFRAMP
                        updatedAt: '2026-01-24T21:05:10.778Z'
                        wallet:
                          address: '0x969838345E5cd5F755DfcADB57e72F5d23271e48'
                          configurations:
                            addresses:
                              prefunding:
                                isActive: false
                                rules: []
                            autoSettlement:
                              isActive: false
                              rules: []
                            autoSweeping:
                              isActive: true
                              threshold: 0
                            withdrawal:
                              gasless:
                                isActive: false
                                operator: gt
                                threshold: 0
                          createdAt: '2026-01-20T08:44:44.305Z'
                          derivationPath: m/44'/60'/0'/0/0
                          description: This is Base master Wallet
                          id: 7aa5120b-2106-43c6-92c7-6458b7d2de8b
                          isActive: true
                          name: Base Mainnet
                          network: mainnet
                          status: ACTIVE
                          updatedAt: '2026-01-20T08:44:44.305Z'
                    message: Withdraw fiat execution initiated
                    statusCode: 200
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: x-api-key
      in: header

````