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.

POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw/network-fee

Child Address Network Fee

cURL

curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/addresses/{addressId}/withdraw/network-fee \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "assets": [
    {
      "address": "0xRecipient1Address",
      "amount": "10.5",
      "id": "{{assetId1}}"
    },
    {
      "address": "0xRecipient2Address",
      "amount": "25.0",
      "id": "{{assetId2}}"
    }
  ]
}
'

200

Withdraw

{
  "data": {
    "nativeBalance": "0.04998428208321722",
    "networkFee": "0.000000021112014"
  },
  "message": "Network fee fetched successfully",
  "statusCode": 200
}

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:

{
  "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:

{
  "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

Authorizations

x-api-key · string · header · required

Path Parameters

walletId · string · required

Example:

"YOUR_WALLET_ID"

addressId · string · required

Example:

"ADDRESS_ID"

Body

application/json

address · string

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 · object[]

Show child attributes

Example:

[
  {
    "address": "0xRecipient1Address",
    "amount": "10.5",
    "id": "{{assetId1}}"
  },
  {
    "address": "0xRecipient2Address",
    "amount": "25.0",
    "id": "{{assetId2}}"
  }
]

Response

200 - application/json

Withdraw / Withdraw (Batch)

data · object

Show child attributes

message · string

Example:

"Network fee fetched successfully"

statusCode · number

Example:

200