Developer Quickstart

Make your first TronSave API call — get a key, estimate, buy, and confirm an Energy order in about 10 minutes.

This guide walks you through your first TronSave API call — from getting an API key to having your first Energy order successfully filled — in about 10 minutes.

Before you begin

TronSave supports two authentication methods for API calls. Choose the one that fits your use case:

	API Key (Internal Account)	Signed Transaction
Best for	Automated bots, backend services	When you prefer not to hold TRX in TronSave
How it works	Deposit TRX into your internal account; TronSave deducts costs automatically	Sign a TRX transaction from your own wallet on each purchase
Complexity	Simpler	Requires TronWeb integration
Recommended	For most use cases	When you need full custody

This guide uses the API Key method. If you want to use Signed Transaction instead, see Buy Resources → Signed Transaction. For a deeper comparison, see Authentication.

Step 1 — Get an API key and deposit TRX

1.1 Get your API key

1. Go to tronsave.io/market and click Connect to connect your wallet.

2. After connecting, click the Address button → select Account Info → click Login TronSave and sign in to confirm.

3. Your API key and deposit address will be displayed — copy and save them.

Testing? Use the Nile testnet at testnet.tronsave.io — everything works the same way but uses no real TRX. See the Test Environment table below.

1.2 Deposit TRX into your internal account

Click Top Up to get your deposit address, then send TRX to that address from any wallet.

A few things to note:

• Minimum deposit is 10 TRX per transaction.

• Your first deposit requires an extra ~1 TRX to activate the new address.

• You get 2 free deposits per day; each additional deposit costs 0.3 TRX.

• Your balance updates automatically in about 3 seconds.

Verify your balance via API:

GET https://api.tronsave.io/v2/user-info
Headers: { "apikey": "YOUR_API_KEY" }

{
  "error": false,
  "data": {
    "balance": "50000000",         // 50 TRX (unit: SUN — 1 TRX = 1,000,000 SUN)
    "depositAddress": "TKVSa...",  // Send TRX to this address to top up
    "representAddress": "TKVSa..." // Used as the "requester" field when placing orders
  }
}

Step 2 — Estimate the cost

Before placing an order, call the estimate endpoint to see how much TRX the order will cost.

POST https://api.tronsave.io/v2/estimate-buy-resource
Content-Type: application/json

{
  "receiver": "YOUR_TRON_RECEIVER_ADDRESS",
  "resourceType": "ENERGY",
  "resourceAmount": 65000,
  "durationSec": 900,
  "unitPrice": "MEDIUM"
}

Request fields:

Field	Example	Description
receiver	"TFwUFW..."	The TRON address that will receive the Energy
resourceAmount	32000	Amount of Energy to buy (a single USDT TRC-20 transfer costs ~32,000 Energy)
durationSec	259200	Rental duration in seconds — 259200 = 3 days
unitPrice	"MEDIUM"	See the pricing table below

Choosing unitPrice:

Value	When to use	Price level
"MEDIUM"	Default — suitable for most cases	Moderate
"FAST"	Need the order filled immediately	Higher
"SLOW"	Not time-sensitive, prioritize savings	Lowest
number (SUN)	Full price control, e.g. 80	Custom

Response:

{
  "error": false,
  "data": {
    "unitPrice": 64,
    "durationSec": 900,
    "estimateTrx": 4230000,    // Estimated cost: 4.23 TRX
    "availableResource": 65000 // Market currently has enough Energy available
  }
}

If availableResource If it is less than your requested resourceAmount, the market currently does not have enough Energy available to fill the order fully. See options.allowPartialFill in the next step.

Step 3 — Create a buy order

Once you've confirmed the cost looks reasonable, create the order:

POST https://api.tronsave.io/v2/buy-resource
Headers: { "apikey": "YOUR_API_KEY" }
Content-Type: application/json

{
  "receiver": "YOUR_TRON_RECEIVER_ADDRESS",
  "resourceType": "ENERGY",
  "resourceAmount": 65000,
  "durationSec": 900,
  "unitPrice": "MEDIUM",
  "options": {
    "allowPartialFill": true,
    "preventDuplicateIncompleteOrders": true
  }
}

Recommended options config:

// For production bots (most common setup)
{
  "allowPartialFill": true,                 // Accept partial fill if market supply is low
  "preventDuplicateIncompleteOrders": true, // Prevent duplicate orders on retry
  "maxPriceAccepted": 100                   // Reject if unit price exceeds 100 SUN
}

// For urgent / must-fill-now orders
{
  "allowPartialFill": true,
  "onlyCreateWhenFulfilled": true
}

Success response:

{
  "error": false,
  "data": {
    "orderId": "6818426a65fa8ea36d119999"
  }
}

Save the orderId — You'll need it in the next step.

Step 4 — Check order status

GET https://api.tronsave.io/v2/order/6818426a65fa8ea36d119999
Headers: { "apikey": "YOUR_API_KEY" }

{
  "error": false,
  "data": {
    "id": "6818426a65fa8ea36d119999",
    "resourceAmount": 65000,
    "resourceType": "ENERGY",
    "fulfilledPercent": 100,   // 100 = order fully matched
    "remainAmount": 0,
    "price": 64,               // Actual unit price (SUN)
    "payoutAmount": 4230000,   // Total charged (SUN)
    "durationSec": 900,
    "delegates": [
      {
        "delegator": "THnnMC...", // Provider who delegated the Energy
        "amount": 65000,
        "txid": "19d3fa..."       // On-chain transaction ID
      }
    ]
  }
}

Reading fulfilledPercent:

Value	Meaning
100	Order fully matched — Energy has been delegated
1–99	Partially matched (only possible when allowPartialFill: true)
0	Pending — waiting for a provider to match

Energy is typically delegated within a few seconds to a few minutes after the order is matched.

Full example (JavaScript)

A complete flow from estimate to order verification:

const TRONSAVE_API = "https://api.tronsave.io";
const API_KEY = "YOUR_API_KEY";
const RECEIVER = "YOUR_TRON_RECEIVER_ADDRESS";

async function buyEnergy(amount = 32000, durationSec = 259200) {
  // Step 1: Estimate cost
  const estimateRes = await fetch(`${TRONSAVE_API}/v2/estimate-buy-resource`, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      receiver: RECEIVER,
      resourceType: "ENERGY",
      resourceAmount: amount,
      durationSec,
      unitPrice: "MEDIUM",
    }),
  });
  const { data: estimate } = await estimateRes.json();
  console.log(`Estimated cost: ${estimate.estimateTrx / 1e6} TRX`);

  // Step 2: Create a buy order
  const buyRes = await fetch(`${TRONSAVE_API}/v2/buy-resource`, {
    method: "POST",
    headers: {
      "apikey": API_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      receiver: RECEIVER,
      resourceType: "ENERGY",
      resourceAmount: amount,
      durationSec,
      unitPrice: "MEDIUM",
      options: {
        allowPartialFill: true,
        preventDuplicateIncompleteOrders: true,
        maxPriceAccepted: 100,
      },
    }),
  });
  const { data: order } = await buyRes.json();
  console.log(`Order created: ${order.orderId}`);

  // Step 3: Wait and check order status
  await new Promise((r) => setTimeout(r, 5000)); // Wait 5 seconds

  const statusRes = await fetch(`${TRONSAVE_API}/v2/order/${order.orderId}`, {
    headers: { "apikey": API_KEY },
  });
  const { data: status } = await statusRes.json();

  if (status.fulfilledPercent === 100) {
    console.log(`Successfully delegated ${status.resourceAmount} Energy to ${RECEIVER}`);
  } else {
    console.log(`Order pending... ${status.fulfilledPercent}% filled`);
  }

  return status;
}

buyEnergy();

Prefer an SDK? The SDK (TypeScript, Rust, Python, Java, PHP) is faster to get started:

npm install tronsave-sdk

This installs the TypeScript package; see the SDK page for the other languages.

Test environment (Nile testnet)

Replace the base URL when testing:

	Production	Testnet
Website	https://tronsave.io	https://testnet.tronsave.io
API	https://api.tronsave.io	https://api-dev.tronsave.io

All endpoint paths remain the same — only the domain changes. See Environments & Networks for details.

Next steps

Now that you've placed your first order, you can:

• Extend an order — Renew the rental duration before it expires without creating a new order.

• View order history — Track all orders under your account.

• Buy with Signed Transaction — If you prefer not to hold TRX inside TronSave.

• Full code examples — Complete working examples in JS, PHP, and Python.

---

Need help? Reach out on Telegram or check the FAQ.