send
rpc

Estimate Fee

Calculates the fees required to send a message. Provide the destination address and message body. For new contract deployments, also include init_code and init_data. Set ignore_chksig to true when estimating before signing. Returns a breakdown of storage, gas, and forwarding fees.

post/api/v2/estimateFee

Request

  • Base URL: https://toncenter.com (the document declares no server; this is the origin it was published from)
  • URL: https://toncenter.com/api/v2/estimateFee
  • Auth: one of:
    • API key in header X-API-Key
    • API key in query parameter api_key

Request body

addressstring required

Account address in raw format (e.g., 0:ca6e321c...) or user-friendly format (e.g., EQDKbjIcfM...). All formats are automatically detected.

bodystring required

Binary data encoded as base64. Used for serialized cells (BoC format), message bodies, and smart contract code/data.

init_codestring

Binary data encoded as base64. Used for serialized cells (BoC format), message bodies, and smart contract code/data.

init_datastring

Binary data encoded as base64. Used for serialized cells (BoC format), message bodies, and smart contract code/data.

ignore_chksigboolean

Set to true to skip signature verification during fee estimation; otherwise false. Useful when a real signature is not yet available.

Response

Returns the estimated fees (gas, storage, forwarding) for the specified message.

okboolean required

Returns true if the request succeeded; otherwise false. See the error field for details.

@extrastring required
jsonrpcstring

JSON-RPC protocol version identifier.

idstring

Changes

No recorded changes to this operation across all 1 revision of this API.