TON DocsTON Docs
OnboardingNodesApplicationsAPIsContractsSmart contractsTolkTolk languageTVMTON Virtual MachineFoundationsBlockchain foundations

Estimate fee

POST
/api/v2/estimateFee

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.

Authorization

X-API-Key<token>

API key header of the form X-API-Key: <token>, where <token> is the API key. Requests without a key are limited to 1 RPS. Refer to the authentication guide for details.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Request to estimate transaction fees. Include the target address, message body, and optionally init code/data for contract deployment.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v2/estimateFee" \  -H "Content-Type: application/json" \  -d '{    "address": "string",    "body": "string"  }'
{  "ok": true,  "result": {    "@type": "query.fees",    "source_fees": {      "@type": "fees",      "in_fwd_fee": 0,      "storage_fee": 0,      "gas_fee": 0,      "fwd_fee": 0    },    "destination_fees": [      {        "@type": "fees",        "in_fwd_fee": 0,        "storage_fee": 0,        "gas_fee": 0,        "fwd_fee": 0      }    ]  },  "@extra": "string"}