Simple Mode

Simple Mode allows you to build, sign, and send a transaction using just one API call.
This is ideal for rapid integrations, personal tooling, or low-risk environments.

---

#⚠️ Security Warning

🚨 WARNING: This method requires you to send your private key in the request body.

• Never use Simple Mode in a client-side or browser-based app.
• Only use with temporary or low-value keys.
• Always use HTTPS and secure your server environment.
• Prefer manual signing for production or high-value flows.

---

#✅ Use Cases

• Automating withdrawals or token distributions
• Backend server tasks
• Testing and scripting flows quickly

---

#🧾 Supported Transaction Types

• TRX: TRX transfers
• TRC10: Token transfers (TRC10)
• TRC20: Smart contract-based transfers

---

#🛠️ Endpoint: Build & Send Transaction

 1POST /api/v1/transactions/simple
 2Host: tronfuel.dev
 3Authorization: Bearer YOUR_API_KEY
 4Content-Type: application/json
 5
 6{
 7  "type": "TRC20",
 8  "to": "TLtHQYAjxk3NGBeWij7EvUtL6P4xt2gngn",
 9  "from": "TRvH8C7wak5aW5jzMS7s2t1JjEYmhCBWy5",
10  "contract": "TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf",
11  "amount": 1,
12  "privatekey": "0a2ce9eff701c59ef73972f319d8b6c4ff776bed97b78a94678d9c36a0cbd7b7"
13}

#✅ Response:

 1{
 2  "status": 201,
 3  "ok": true,
 4  "message": "Transaction created and submitted successfully",
 5  "data": {
 6    "id": "01984227-e2ee-7177-9a8c-d3b7a4142904",
 7    "txid": "c3b257b2d69da9355cfd2778653023edce08cf359a0ba21dfdf406303fe22bf0",
 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:16:07.000000Z",
15    "updated_at": "2025-07-25T15:16:07.000000Z"
16  }
17}

---

#📊 Estimate Fee (Optional)

You can simulate the transaction and get an estimated cost before sending it.

 1POST /api/v1/transactions/simple/estimate
 2Host: tronfuel.dev
 3Authorization: Bearer YOUR_API_KEY
 4Content-Type: application/json
 5
 6{
 7  "type": "TRC20",
 8  "to": "TLtHQYAjxk3NGBeWij7EvUtL6P4xt2gngn",
 9  "from": "TRvH8C7wak5aW5jzMS7s2t1JjEYmhCBWy5",
10  "contract": "TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf",
11  "amount": 1,
12  "privatekey": "0a2ce9eff701c59ef73972f319d8b6c4ff776bed97b78a94678d9c36a0cbd7b7"
13}

#🧮 Response:

 1{
 2  "status": 200,
 3  "ok": true,
 4  "message": "Transaction fee estimated successfully",
 5  "data": [
 6    {
 7      "bandwidth": 345,
 8      "bandwidth_available": 600,
 9      "bandwidth_needed": 0,
10      "bandwidth_cost": 0,
11      "energy": 32000,
12      "energy_cost": 3.064,
13      "account_activated": false,
14      "account_activation_cost": 1.4,
15      "fee": 4.464
16    }
17  ]
18}

---

#🧷 Parameters Reference

• type (required): Transaction type. One of TRX, TRC10, or TRC20.
• to (required): Destination wallet address.
• from (required): Sender wallet address (must match the private key).
• contract (required for TRC20): Contract address of the TRC20 token.
• amount (required): Amount to transfer (in token units, not SUN).
• privatekey (required): Hex-encoded private key of the sender.

---

#🔐 Best Practices

• Use simple mode only in trusted backend systems.
• Store private keys securely (e.g., environment variables, secret managers).
• Use simple/estimate to preview fees before sending large amounts.
• For production-grade usage, use the Transaction Builder, sign locally, and then call Send Transactions.