> ## 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 API provides endpoints for interacting with smart contracts on the blockchain. It allows estimating network fees.

### Request Body

The request body should be in raw format and include the following parameters:

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| address | string | Yes | The address of the contract. |
| method | string | Yes | The method to be called on the contract. |
| parameters | array | Yes | An array of parameters to pass to the method. |
| abi | array | Yes | An array containing the ABI of the contract or method. |

## Batch Operations

This endpoint supports batch operations, allowing you to estimate network fees for multiple contract operations from a specific child address in a single API call.

### Batch Request Format

To estimate fees for multiple operations, use the `calls` array:

```json theme={null}
{
  "calls": [
    {
      "address": "0xTokenContract...",
      "method": "approve",
      "parameters": ["0xSpender...", "1000000000000000000"],
      "abi": [...]
    },
    {
      "address": "0xProtocolContract...",
      "method": "deposit",
      "parameters": ["1000000000000000000"],
      "abi": [...]
    }
  ]
}
```

### Batch Response Format

Returns individual fees plus totals:

```json theme={null}
{
  "message": "Batch network fee retrieved (2/2 successful)",
  "statusCode": 200,
  "data": {
    "fees": [
      {
        "index": 0,
        "method": "approve",
        "fee": "0.00001247904",
        "networkFee": "0.00001247904",
        "networkFeeInUSD": "0.01",
        "nativeBalance": "0.5",
        "nativeBalanceInUSD": "450.00",
        "estimatedArrivalTime": 30,
        "transactionFee": "0"
      },
      {
        "index": 1,
        "method": "deposit",
        "fee": "0.00000504",
        "networkFee": "0.00000504",
        "networkFeeInUSD": "0.005",
        "nativeBalance": "0.5",
        "nativeBalanceInUSD": "450.00",
        "estimatedArrivalTime": 30,
        "transactionFee": "0"
      }
    ],
    "totalFee": "0.00001751904",
    "estimatedArrivalTime": 60,
    "errors": []
  }
}
```

### Response Fields

| Field                | Description                                    |
| -------------------- | ---------------------------------------------- |
| fees                 | Array of individual fee estimates              |
| totalFee             | Sum of all network fees                        |
| 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

* **Fee estimation**: Calculate total cost before executing batch operations
* **Gas optimization**: Compare fees across different operation orderings
* **Budget planning**: Estimate costs for multi-step DeFi transactions


## OpenAPI

````yaml post /wallets/{walletId}/addresses/{addressId}/contracts/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: >-
      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:
  /wallets/{walletId}/addresses/{addressId}/contracts/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:
        - Smart Contract
      summary: Child Address Network Fee
      description: >-
        This API provides endpoints for interacting with smart contracts on the
        blockchain. It allows estimating network fees.


        ### Request Body


        The request body should be in raw format and include the following
        parameters:


        | Parameter | Type | Required | Description |

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

        | address | string | Yes | The address of the contract. |

        | method | string | Yes | The method to be called on the contract. |

        | parameters | array | Yes | An array of parameters to pass to the
        method. |

        | abi | array | Yes | An array containing the ABI of the contract or
        method. |
      operationId: childAddressNetworkFee1
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                calls:
                  type: array
                  items:
                    type: object
                    properties:
                      abi:
                        type: array
                        items:
                          type: object
                          properties:
                            constant:
                              type: boolean
                              example: false
                            inputs:
                              type: array
                              items:
                                type: object
                                properties:
                                  name:
                                    type: string
                                    example: _to
                                  type:
                                    type: string
                                    example: address
                              example:
                                - name: _to
                                  type: address
                                - name: _value
                                  type: uint256
                            name:
                              type: string
                              example: transfer
                            outputs:
                              type: array
                              items: {}
                              example: []
                            payable:
                              type: boolean
                              example: false
                            stateMutability:
                              type: string
                              example: nonpayable
                            type:
                              type: string
                              example: function
                        example:
                          - constant: false
                            inputs:
                              - name: _to
                                type: address
                              - name: _value
                                type: uint256
                            name: transfer
                            outputs: []
                            payable: false
                            stateMutability: nonpayable
                            type: function
                      address:
                        type: string
                        example: '0x337610d27c682E347C9cD60BD4b3b107C9d34dDd'
                      method:
                        type: string
                        example: transfer
                      parameters:
                        type: array
                        items:
                          type: string
                          example: '0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22'
                        example:
                          - '0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22'
                          - '10000'
                  example:
                    - abi:
                        - constant: false
                          inputs:
                            - name: _to
                              type: address
                            - name: _value
                              type: uint256
                          name: transfer
                          outputs: []
                          payable: false
                          stateMutability: nonpayable
                          type: function
                      address: '0x337610d27c682E347C9cD60BD4b3b107C9d34dDd'
                      method: transfer
                      parameters:
                        - '0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22'
                        - '10000'
                    - abi:
                        - constant: false
                          inputs:
                            - name: _to
                              type: address
                            - name: _value
                              type: uint256
                          name: transfer
                          outputs: []
                          payable: false
                          stateMutability: nonpayable
                          type: function
                      address: '0x337610d27c682E347C9cD60BD4b3b107C9d34dDd'
                      method: transfer
                      parameters:
                        - '0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22'
                        - '10000'
            examples:
              Child Address Network Fee:
                value:
                  calls:
                    - abi:
                        - constant: false
                          inputs:
                            - name: _to
                              type: address
                            - name: _value
                              type: uint256
                          name: transfer
                          outputs: []
                          payable: false
                          stateMutability: nonpayable
                          type: function
                      address: '0x337610d27c682E347C9cD60BD4b3b107C9d34dDd'
                      method: transfer
                      parameters:
                        - '0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22'
                        - '10000'
                    - abi:
                        - constant: false
                          inputs:
                            - name: _to
                              type: address
                            - name: _value
                              type: uint256
                          name: transfer
                          outputs: []
                          payable: false
                          stateMutability: nonpayable
                          type: function
                      address: '0x337610d27c682E347C9cD60BD4b3b107C9d34dDd'
                      method: transfer
                      parameters:
                        - '0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22'
                        - '10000'
      responses:
        '200':
          description: Ethereum / Tron / Ethereum (Batch) / Tron (Batch)
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      balance:
                        type: string
                        example: '1.012299726305777896'
                      errors:
                        type: array
                        items: {}
                        example: []
                      estimatedArrivalTime:
                        type: number
                        example: 60
                      fee:
                        type: string
                        example: '0.00422709309982132'
                      fees:
                        type: array
                        items:
                          type: object
                          properties:
                            balance:
                              type: string
                              example: '0.073661808182044578'
                            estimatedArrivalTime:
                              type: number
                              example: 30
                            fee:
                              type: string
                              example: '0.00000835248'
                            index:
                              type: number
                              example: 0
                            method:
                              type: string
                              example: transfer
                            nativeBalance:
                              type: string
                              example: '0.073661808182044578'
                            nativeBalanceInUSD:
                              type: string
                              example: '66.51882264263171527134'
                            networkFee:
                              type: string
                              example: '0.00000835248'
                            networkFeeInUSD:
                              type: string
                              example: '0.0075425400144'
                            transactionFee:
                              type: string
                              example: '0'
                        example:
                          - balance: '0.073661808182044578'
                            estimatedArrivalTime: 30
                            fee: '0.00000835248'
                            index: 0
                            method: transfer
                            nativeBalance: '0.073661808182044578'
                            nativeBalanceInUSD: '66.51882264263171527134'
                            networkFee: '0.00000835248'
                            networkFeeInUSD: '0.0075425400144'
                            transactionFee: '0'
                          - balance: '0.073661808182044578'
                            estimatedArrivalTime: 30
                            fee: '0.00000835248'
                            index: 1
                            method: transfer
                            nativeBalance: '0.073661808182044578'
                            nativeBalanceInUSD: '66.51882264263171527134'
                            networkFee: '0.00000835248'
                            networkFeeInUSD: '0.0075425400144'
                            transactionFee: '0'
                      totalFee:
                        type: string
                        example: '0.00001670496'
                  message:
                    type: string
                    example: Network fee retrieved successfully
                  statusCode:
                    type: number
                    example: 200
              examples:
                Ethereum:
                  value:
                    data:
                      balance: '1.012299726305777896'
                      fee: '0.00422709309982132'
                    message: Network fee retrieved successfully
                    statusCode: 200
                Ethereum (Batch):
                  value:
                    data:
                      errors: []
                      estimatedArrivalTime: 60
                      fees:
                        - balance: '0.073661808182044578'
                          estimatedArrivalTime: 30
                          fee: '0.00000835248'
                          index: 0
                          method: transfer
                          nativeBalance: '0.073661808182044578'
                          nativeBalanceInUSD: '66.51882264263171527134'
                          networkFee: '0.00000835248'
                          networkFeeInUSD: '0.0075425400144'
                          transactionFee: '0'
                        - balance: '0.073661808182044578'
                          estimatedArrivalTime: 30
                          fee: '0.00000835248'
                          index: 1
                          method: transfer
                          nativeBalance: '0.073661808182044578'
                          nativeBalanceInUSD: '66.51882264263171527134'
                          networkFee: '0.00000835248'
                          networkFeeInUSD: '0.0075425400144'
                          transactionFee: '0'
                      totalFee: '0.00001670496'
                    message: Batch network fee retrieved (2/2 successful)
                    statusCode: 200
                Tron:
                  value:
                    data:
                      balance: '38.63849'
                      fee: '5.6406'
                    message: Network fee retrieved successfully
                    statusCode: 200
                Tron (Batch):
                  value:
                    data:
                      errors: []
                      estimatedArrivalTime: 60
                      fees:
                        - balance: '0.073661808182044578'
                          estimatedArrivalTime: 30
                          fee: '0.00000835248'
                          index: 0
                          method: transfer
                          nativeBalance: '0.073661808182044578'
                          nativeBalanceInUSD: '66.51882264263171527134'
                          networkFee: '0.00000835248'
                          networkFeeInUSD: '0.0075425400144'
                          transactionFee: '0'
                        - balance: '0.073661808182044578'
                          estimatedArrivalTime: 30
                          fee: '0.00000835248'
                          index: 1
                          method: transfer
                          nativeBalance: '0.073661808182044578'
                          nativeBalanceInUSD: '66.51882264263171527134'
                          networkFee: '0.00000835248'
                          networkFeeInUSD: '0.0075425400144'
                          transactionFee: '0'
                      totalFee: '0.00001670496'
                    message: Batch network fee retrieved (2/2 successful)
                    statusCode: 200
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: x-api-key
      in: header

````