Authentication
How TronSave authenticates API requests — Internal Account, API Key, and Signed Transaction.
Every TronSave API request must be authenticated. There are two methods: an API Key tied to a TronSave Internal Account, or a Signed Transaction, where you pay from your own wallet per purchase. This page explains both and shows how to obtain an API Key on the website or via Telegram.
Internal Account and API Key
A TronSave Internal Account is a TronSave-managed balance. You deposit TRX into it once, and the API spends from that balance automatically when you place orders. It also tracks your transaction history and lets you manage assets within the system.
Each Internal Account is assigned a unique API Key — a secret identifier issued by TronSave and linked to that account. The API Key lets you or a third-party application (a bot, an automated service) send commands to the Internal Account without logging into the website or app. Every request — checking balances, creating orders, extending orders — is tied to the Internal Account through the API Key.
In short:
The Internal Account is where your assets are stored and managed.
The API Key is the tool that grants secure, automated access to that account.
Your API Key controls spending from your Internal Account. Treat it like a password: never commit it to source control, never expose it in client-side code, and never share it. Anyone with your key can place orders that spend your deposited TRX.
The two authentication methods
How it works
Requests carry your API Key; orders are paid from your Internal Account balance
You sign a TRX payment from your own wallet for each purchase
Custody
Funds held in a TronSave-managed Internal Account
Full self-custody — you keep your funds
Setup
Get an API Key, deposit TRX once
No deposit; sign per transaction
Best for
Bots and automated services making frequent calls
Users who want to retain custody and pay as they go
Sent as
apikey request header
A signed transaction in the request body
With the API Key method, you send the key in the apikey header:
curl -X POST https://api.tronsave.io/v2/buy-resource \
-H "apikey: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{ ... }'For the terminology used here, see the Glossary.
Get an API Key
You can obtain your API Key directly from the website or via Telegram.
Step 1 — Get the deposit address and API Key
Go to tronsave.io.
Click the Connect button.
Choose a wallet option and sign in to connect.
After connecting, select Account info.
Click the Login TRONSAVE button and Sign.
Your API Key and deposit address are displayed.
Note: If you're using the Nile testnet, use this URL instead: https://testnet.tronsave.io/
Step 2 — Deposit by transferring TRX
Click the Top up button to get the deposit address.
Transfer TRX to this address.
Sign to confirm the transaction.
The new balance auto-updates in about 3 seconds.
The minimum deposit is 10 TRX.
Your first deposit requires an additional fee of approximately 1 TRX to activate the new address.
You can make 2 deposit transactions with TRX per day without fees. After that, each additional deposit incurs a 0.3 TRX fee.
Open the TronSave Telegram bot (@BuyEnergyTronsave_bot) and go to User Info.
Select the API key button.
Click on the API Key to copy it.
Revoking and rotating your key
If you need to change your API Key, select Revoke to generate a new one. This works the same way on the website and on Telegram: confirm the action to create a new key, or cancel to keep the current one.
We do not recommend changing the API Key. Revoking invalidates the old key — any bot or service still using it will stop working. Only revoke if necessary (for example, if the key may have been exposed).
Next steps
Developer Quickstart — get a key, deposit, and place your first order
API Reference — full endpoint list
Last updated