Master Wallet Network Fee

curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/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}}"
    }
  ]
}
'

import requests

url = "https://api.blockradar.co/v1/wallets/{walletId}/withdraw/network-fee"

payload = { "assets": [
        {
            "address": "0xRecipient1Address",
            "amount": "10.5",
            "id": "{{assetId1}}"
        },
        {
            "address": "0xRecipient2Address",
            "amount": "25.0",
            "id": "{{assetId2}}"
        }
    ] }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    assets: [
      {address: '0xRecipient1Address', amount: '10.5', id: '{{assetId1}}'},
      {address: '0xRecipient2Address', amount: '25.0', id: '{{assetId2}}'}
    ]
  })
};

fetch('https://api.blockradar.co/v1/wallets/{walletId}/withdraw/network-fee', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.blockradar.co/v1/wallets/{walletId}/withdraw/network-fee",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'assets' => [
        [
                'address' => '0xRecipient1Address',
                'amount' => '10.5',
                'id' => '{{assetId1}}'
        ],
        [
                'address' => '0xRecipient2Address',
                'amount' => '25.0',
                'id' => '{{assetId2}}'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.blockradar.co/v1/wallets/{walletId}/withdraw/network-fee"

	payload := strings.NewReader("{\n  \"assets\": [\n    {\n      \"address\": \"0xRecipient1Address\",\n      \"amount\": \"10.5\",\n      \"id\": \"{{assetId1}}\"\n    },\n    {\n      \"address\": \"0xRecipient2Address\",\n      \"amount\": \"25.0\",\n      \"id\": \"{{assetId2}}\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.blockradar.co/v1/wallets/{walletId}/withdraw/network-fee")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"assets\": [\n    {\n      \"address\": \"0xRecipient1Address\",\n      \"amount\": \"10.5\",\n      \"id\": \"{{assetId1}}\"\n    },\n    {\n      \"address\": \"0xRecipient2Address\",\n      \"amount\": \"25.0\",\n      \"id\": \"{{assetId2}}\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.blockradar.co/v1/wallets/{walletId}/withdraw/network-fee")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"assets\": [\n    {\n      \"address\": \"0xRecipient1Address\",\n      \"amount\": \"10.5\",\n      \"id\": \"{{assetId1}}\"\n    },\n    {\n      \"address\": \"0xRecipient2Address\",\n      \"amount\": \"25.0\",\n      \"id\": \"{{assetId2}}\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

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

Withdraw

Master Wallet Network Fee

This API endpoint is used to get the withdrawal network fee from a specific wallet.

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

wallets

{walletId}

withdraw

network-fee

Master Wallet Network Fee

curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/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}}"
    }
  ]
}
'

import requests

url = "https://api.blockradar.co/v1/wallets/{walletId}/withdraw/network-fee"

payload = { "assets": [
        {
            "address": "0xRecipient1Address",
            "amount": "10.5",
            "id": "{{assetId1}}"
        },
        {
            "address": "0xRecipient2Address",
            "amount": "25.0",
            "id": "{{assetId2}}"
        }
    ] }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    assets: [
      {address: '0xRecipient1Address', amount: '10.5', id: '{{assetId1}}'},
      {address: '0xRecipient2Address', amount: '25.0', id: '{{assetId2}}'}
    ]
  })
};

fetch('https://api.blockradar.co/v1/wallets/{walletId}/withdraw/network-fee', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.blockradar.co/v1/wallets/{walletId}/withdraw/network-fee",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'assets' => [
        [
                'address' => '0xRecipient1Address',
                'amount' => '10.5',
                'id' => '{{assetId1}}'
        ],
        [
                'address' => '0xRecipient2Address',
                'amount' => '25.0',
                'id' => '{{assetId2}}'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.blockradar.co/v1/wallets/{walletId}/withdraw/network-fee"

	payload := strings.NewReader("{\n  \"assets\": [\n    {\n      \"address\": \"0xRecipient1Address\",\n      \"amount\": \"10.5\",\n      \"id\": \"{{assetId1}}\"\n    },\n    {\n      \"address\": \"0xRecipient2Address\",\n      \"amount\": \"25.0\",\n      \"id\": \"{{assetId2}}\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.blockradar.co/v1/wallets/{walletId}/withdraw/network-fee")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"assets\": [\n    {\n      \"address\": \"0xRecipient1Address\",\n      \"amount\": \"10.5\",\n      \"id\": \"{{assetId1}}\"\n    },\n    {\n      \"address\": \"0xRecipient2Address\",\n      \"amount\": \"25.0\",\n      \"id\": \"{{assetId2}}\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.blockradar.co/v1/wallets/{walletId}/withdraw/network-fee")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"assets\": [\n    {\n      \"address\": \"0xRecipient1Address\",\n      \"amount\": \"10.5\",\n      \"id\": \"{{assetId1}}\"\n    },\n    {\n      \"address\": \"0xRecipient2Address\",\n      \"amount\": \"25.0\",\n      \"id\": \"{{assetId2}}\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "nativeBalance": "0.04998428208321722",
    "nativeBalanceInUSD": "4950.00",
    "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 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

授权

x-api-key

string

header

必填

路径参数

walletId

string

必填

示例:

"{{walletId}}"

请求体

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

示例:

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

响应

200 - application/json

Withdraw / Withdraw (Batch)

data

object

Show child attributes

message

string

示例:

"Network fee fetched successfully"

statusCode

number

示例:

200

​Batch Operations

​Batch Request Format

​Batch Response Format

​Response Fields

​Validation Rules

​Use Cases

授权

路径参数

请求体

响应

Batch Operations

Batch Request Format

Batch Response Format

Response Fields

Validation Rules

Use Cases