Estimate fee

Estimates the fees required to process a transaction. Accepts a target address and serialized message body, init-code, and init-data (all base64-encoded). Returns a breakdown of source and destination fees including storage, gas, and forwarding costs.

POST /api/v3/estimateFee

Estimate fee

cURL

curl --request POST \
  --url https://toncenter.com/api/v3/estimateFee \
  --header 'Content-Type: application/json' \
  --data '
{
  "address": "<string>",
  "body": "<string>",
  "ignore_chksig": true,
  "init_code": "<string>",
  "init_data": "<string>"
}
'

200

{
  "destination_fees": [
    {
      "fwd_fee": 123,
      "gas_fee": 123,
      "in_fwd_fee": 123,
      "storage_fee": 123
    }
  ],
  "source_fees": {
    "fwd_fee": 123,
    "gas_fee": 123,
    "in_fwd_fee": 123,
    "storage_fee": 123
  }
}

Body

application/json

Request body for fee estimation. Provide the target address, base64-encoded message body, and optionally init code and init data (for contract deployment messages). Set ignore_chksig to true to skip signature verification when you don't have a real signature yet.

address · string

Target account address that will receive and process the message.

body · string

Message body in BOC format, base64 encoded. Contains the operation to be executed.

ignore_chksig · boolean

Set to true to skip signature verification during fee estimation. Useful when estimating fees before signing the message.

init_code · string

Contract code for deployment messages, BOC format, base64 encoded. Required when deploying a new contract; omit for regular transfers.

init_data · string

Initial contract storage for deployment, BOC format, base64 encoded. Required when deploying a new contract; omit for regular transfers.

Response

200 - application/json

Estimated fee breakdown for source and destination accounts.

Fee estimation result with separate breakdowns for the sending account (source) and receiving account(s) (destination). Each breakdown includes forwarding, gas, inbound forwarding, and storage fees in nanotons.

destination_fees · object[]

Array of fee breakdowns charged on the receiving account(s). One entry per destination in multi-hop transactions.

Show child attributes

source_fees · object

Fees charged on the sending account.

Show child attributes