> ## 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 Network Fee > This endpoint is used to calculate the network fee for a withdrawal from a specific address. ### Body Parameters | Key | Required | Type | Description | | --- | --- | --- | --- | | assetId | true\* | string (UUID) | The ID of the asset to withdraw. Required if `assets` array is **not** provided. | | address | true\* | string | The destination wallet address for the withdrawal. Required if `assets` array is **not** provided. | | amount | true\* | string | The withdrawal amount. Must be greater than 0. Required if `assets` array is **not** provided. | | reference | false | string | An optional reference note for the withdrawal. | | **note** | false | string | A short message or internal remark to associate with this withdrawal. Not visible on-chain, except on Stellar, where it is attached as the transaction memo. | | metadata | false | object | Optional metadata (key-value pairs) for additional transaction details. | ## Batch Operations This endpoint supports batch operations, allowing you to estimate network fees for multiple withdrawal operations from a specific child address in a single API call. ### Batch Request Format To estimate fees for multiple withdrawals, use the `assets` array: ```json theme={null} { "assets": [ { "id": "asset-uuid-1", "address": "0xRecipient1...", "amount": "100" }, { "id": "asset-uuid-2", "address": "0xRecipient2...", "amount": "50" } ] } ``` ### Batch Response Format Returns individual fees plus totals: ```json theme={null} { "message": "Network fee fetched successfully", "statusCode": 200, "data": { "fees": [ { "index": 0, "assetId": "asset-uuid-1", "address": "0xRecipient1...", "amount": "100", "networkFee": "0.00001247904", "transactionFee": "0", "estimatedArrivalTime": 30 }, { "index": 1, "assetId": "asset-uuid-2", "address": "0xRecipient2...", "amount": "50", "networkFee": "0.00000504", "transactionFee": "0", "estimatedArrivalTime": 30 } ], "totalNetworkFee": "0.00001751904", "totalNetworkFeeInUSD": "0.0158202186912", "totalTransactionFee": "0", "nativeBalance": "0.073690520542044578", "nativeBalanceInUSD": "66.54", "estimatedArrivalTime": 60, "errors": [] } } ``` ### Response Fields | Field | Description | | -------------------- | ------------------------------------------------ | | fees | Array of individual fee estimates per withdrawal | | totalNetworkFee | Sum of all network fees | | totalNetworkFeeInUSD | Total network fee in USD | | totalTransactionFee | Sum of all transaction fees | | nativeBalance | Current native token balance | | estimatedArrivalTime | Total time (sum of individual times, 30s each) | | errors | Array of any failed estimations | ### Validation Rules | Rule | Value | | -------------- | ------------- | | Max batch size | 20 operations | | Min batch size | 1 operation | ### Use Cases * **Multi-recipient withdrawal**: Estimate fees for sending to multiple addresses * **Bulk payouts**: Calculate total cost for batch payment operations * **Budget planning**: Plan withdrawal operations with accurate fee estimates ## OpenAPI ````yaml post /v1/wallets/{walletId}/addresses/{addressId}/withdraw/network-fee 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: >- Signing service for plain text messages, raw transactions, and EIP-712 typed data. Message signing, transaction signing, and sign-and-broadcast are available on EVM, Tron, Solana, and Stellar. Typed data signing (EIP-712, including EIP-2612 Permit and EIP-3009 TransferWithAuthorization) is EVM-only. - 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/network-fee: 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 post: tags: - Withdraw summary: Child Address Network Fee description: >- This endpoint is used to calculate the network fee for a withdrawal from a specific address. ### Body Parameters | Key | Required | Type | Description | | --- | --- | --- | --- | | assetId | true\* | string (UUID) | The ID of the asset to withdraw. Required if `assets` array is **not** provided. | | address | true\* | string | The destination wallet address for the withdrawal. Required if `assets` array is **not** provided. | | amount | true\* | string | The withdrawal amount. Must be greater than 0. Required if `assets` array is **not** provided. | | reference | false | string | An optional reference note for the withdrawal. | | **note** | false | string | A short message or internal remark to associate with this withdrawal. Not visible on-chain, except on Stellar, where it is attached as the transaction memo. | | metadata | false | object | Optional metadata (key-value pairs) for additional transaction details. | operationId: childAddressNetworkFee requestBody: content: application/json: schema: type: object properties: address: type: string description: >- The destination wallet address used for fee estimation. Stellar accepts classic (G...), muxed (M...), and Soroban contract (C...) recipients. Contract recipients are valid for token assets only, not native XLM. assets: type: array items: type: object properties: address: type: string example: 0xRecipient1Address amount: type: string example: '10.5' id: type: string example: '{{assetId1}}' example: - address: 0xRecipient1Address amount: '10.5' id: '{{assetId1}}' - address: 0xRecipient2Address amount: '25.0' id: '{{assetId2}}' examples: Child Address Network Fee: value: assets: - address: 0xRecipient1Address amount: '10.5' id: '{{assetId1}}' - address: 0xRecipient2Address amount: '25.0' id: '{{assetId2}}' responses: '200': description: Withdraw / Withdraw (Batch) content: application/json: schema: type: object properties: data: type: object properties: errors: type: array items: {} example: [] estimatedArrivalTime: type: number example: 60 fees: type: array items: type: object properties: address: type: string example: '0x8636d866C022abA90AAE13c8fE1De95dFc8Cb701' amount: type: string example: '0.1' assetId: type: string example: ae455f23-3824-4125-baab-d158315cbcbd estimatedArrivalTime: type: number example: 30 index: type: number example: 0 networkFee: type: string example: '0.00001247904' transactionFee: type: string example: '0' example: - address: '0x8636d866C022abA90AAE13c8fE1De95dFc8Cb701' amount: '0.1' assetId: ae455f23-3824-4125-baab-d158315cbcbd estimatedArrivalTime: 30 index: 0 networkFee: '0.00001247904' transactionFee: '0' - address: '0x8636d866C022abA90AAE13c8fE1De95dFc8Cb701' amount: '0.002' assetId: 98582300-2f1d-4ef4-99f2-4361319fc776 estimatedArrivalTime: 30 index: 1 networkFee: '0.00000504' transactionFee: '0' nativeBalance: type: string example: '0.04998428208321722' nativeBalanceInUSD: type: string example: '66.54475076508251527134' networkFee: type: string example: '0.000000021112014' totalNetworkFee: type: string example: '0.00001751904' totalNetworkFeeInUSD: type: string example: '0.0158202186912' totalTransactionFee: type: string example: '0' message: type: string example: Network fee fetched successfully statusCode: type: number example: 200 examples: Withdraw: value: data: nativeBalance: '0.04998428208321722' networkFee: '0.000000021112014' message: Network fee fetched successfully statusCode: 200 Withdraw (Batch): value: data: errors: [] estimatedArrivalTime: 60 fees: - address: '0x8636d866C022abA90AAE13c8fE1De95dFc8Cb701' amount: '0.1' assetId: ae455f23-3824-4125-baab-d158315cbcbd estimatedArrivalTime: 30 index: 0 networkFee: '0.00001247904' transactionFee: '0' - address: '0x8636d866C022abA90AAE13c8fE1De95dFc8Cb701' amount: '0.002' assetId: 98582300-2f1d-4ef4-99f2-4361319fc776 estimatedArrivalTime: 30 index: 1 networkFee: '0.00000504' transactionFee: '0' nativeBalance: '0.073690520542044578' nativeBalanceInUSD: '66.54475076508251527134' totalNetworkFee: '0.00001751904' totalNetworkFeeInUSD: '0.0158202186912' totalTransactionFee: '0' message: Network fee fetched successfully statusCode: 200 components: securitySchemes: apiKey: type: apiKey name: x-api-key in: header ````