跳转到主要内容
POST
/
v1
/
wallets
/
{walletId}
/
contracts
/
network-fee
Master Wallet Network Fee
curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/contracts/network-fee \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "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"
      ]
    }
  ]
}
'
{
"data": {
"balance": "1.012299726305777896",
"fee": "0.00422709309982132"
},
"message": "Network fee retrieved successfully",
"statusCode": 200
}

Batch Operations

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

Batch Request Format

To estimate fees for multiple operations, use the calls array:
{
  "calls": [
    {
      "address": "0xTokenContract...",
      "method": "approve",
      "parameters": ["0xSpender...", "1000000000000000000"],
      "abi": [...]
    },
    {
      "address": "0xProtocolContract...",
      "method": "deposit",
      "parameters": ["1000000000000000000"],
      "abi": [...]
    }
  ]
}

Batch Response Format

Returns individual fees plus totals:
{
  "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

FieldDescription
feesArray of individual fee estimates
totalFeeSum of all network fees
estimatedArrivalTimeTotal time (sum of individual times, 30s each)
errorsArray of any failed estimations

Validation Rules

RuleValue
Max batch size20 operations
Min batch size1 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

授权

x-api-key
string
header
必填

路径参数

walletId
string
必填
示例:

"YOUR_WALLET_ID"

请求体

application/json
calls
object[]
示例:
[
{
"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"
]
}
]

响应

200 - application/json

Ethereum / Tron / Ethereum (Batch) / Tron (Batch)

data
object
message
string
示例:

"Network fee retrieved successfully"

statusCode
number
示例:

200