Features
API Send Transactions — Broadcast Signed Tron Payloads
Tronfuel offers an endpoint to send signed Tron transactions while automatically managing energy and bandwidth allocation. This allows your transactions to execute reliably — even if your wallet has insufficient resources.
#✅ What You Need
Before calling this endpoint, ensure you have:
- A valid signed transaction object (see How to Sign Transactions)
- An active Tronfuel account with sufficient balance
- API key and authorization headers configured
X-Network
header set to eithermainnet
ornile
#⚙️ How It Works
When you send a signed transaction to our API:
- Tronfuel receives your signed transaction.
- The platform analyzes the transaction to determine energy and bandwidth requirements.
- If needed, it delegates resources to the sender address.
- The transaction is broadcasted to the Tron blockchain.
- Confirmation and error status are monitored.
- Webhooks are triggered based on success, failure, or timeout.
- Associated resource fees are deducted from your internal Tronfuel wallet.
#📡 Example Request
Endpoint:
1POST /transactions/build
2Host: tronfuel.dev
3Authorization: Bearer YOUR_API_KEY
4Content-Type: application/json
5{
6 "visible": false,
7 "txID": "b6ed04b2fa51668922bc4152190b26e95e8174d86eef7801d63be3da1a7a729c",
8 "raw_data": {
9 "contract": [
10 {
11 "parameter": {
12 "value": {
13 "data": "a9059cbb000000000000000000000000aef434d3b649333ede3f64456d0ca67d83f871a700000000000000000000000000000000000000000000000000000000000f4240",
14 "owner_address": "4177bafb1379d3b8f85404c8bfa243c4416dcf2092",
15 "contract_address": "41eca9bc828a3005b9a3b909f2cc5c2a54794de05f"
16 },
17 "type_url": "type.googleapis.com/protocol.TriggerSmartContract"
18 },
19 "type": "TriggerSmartContract"
20 }
21 ],
22 "ref_block_bytes": "7f32",
23 "ref_block_hash": "bd5f66a94fdb1076",
24 "expiration": 1751275206000,
25 "fee_limit": 15000000000,
26 "timestamp": 1751275148383
27 },
28 "raw_data_hex": "0a027f322208bd5f66a94fdb107640f0ea8b81fc325aae01081f12a9010a31747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e54726967676572536d617274436f6e747261637412740a154177bafb1379d3b8f85404c8bfa243c4416dcf2092121541eca9bc828a3005b9a3b909f2cc5c2a54794de05f2244a9059cbb000000000000000000000000aef434d3b649333ede3f64456d0ca67d83f871a700000000000000000000000000000000000000000000000000000000000f424070dfa88881fc32900180acc7f037",
29 "signature": [
30 "6e9de05c130f5fcca290fe07e00218a23359faae5255228a86e48e72afa6a7e1f7305bda9b16ba3fbd95811abeff89f627875380ec8c4f026d932852a3529a3400"
31 ]
32}
#⚠️ Important
⏱ Make sure your transaction expiration field is at least 60 seconds in the future when you submit it. Transactions with an already-expired deadline will be rejected immediately.
#🔁 Response
The response contains either:
- The internal transaction ID and tron txid with a queued status
- Or an immediate error with details
1{
2 "status": 201,
3 "ok": true,
4 "message": "Transaction created successfully",
5 "data": {
6 "id": "0198421c-9110-7301-bdcf-b81bcf9b98f1",
7 "txid": "b6ed04b2fa51668922bc4152190b26e95e8174d86eef7801d63be3da1a7a729c",
8 "network": "testnet",
9 "type": "TRC20",
10 "status": "pending",
11 "estimated_energy": 32000,
12 "estimated_bandwidth": 345,
13 "price": 4.464,
14 "created_at": "2025-07-25T15:03:45.000000Z",
15 "updated_at": "2025-07-25T15:03:45.000000Z"
16 }
17}
Need help signing transactions? Check out How to Sign Transactions.