🤖TTRON API

Partner API Documentation

Complete API suite for integrating with TRON energy rental system. Fast integration, reliable performance.

🌐

Base URL

https://api.telegatron.com/api/v1/

🔑

Authentication

X-API-Key Header

📚

Interactive Documentation

https://api.telegatron.com/docs

Available API Methods

GET

/balance

Get current account balance

+

Description: Returns information about your current account balance and wallet address.

Parameters: None required

Response: JSON object with balance in TRX and wallet address

GET

/energy/price

Get energy rental price

+

Description: Returns the price for energy rental with specified parameters.

Parameters:

  • amount (required) – energy amount (65000, 131000, 262000, 524000, 1000000)
  • duration (required) – rental period (1h, 1d, 3d, 1w, 1M)
  • target (optional) – target address

Response: JSON object with price in TRX

POST

/energy/rent

Rent energy for address

+

Description: Creates an energy rental order for the specified TRON address.

Request body parameters:

  • amount – energy amount (integer)
  • duration – rental duration (1h, 1d, 3d, 1w, 1M)
  • target – target TRON address
  • currency – payment currency (TRX, RUB)

Response: JSON object with rental order information, including rental ID and transaction hash

GET

/bandwidth/price

Get bandwidth rental price

+

Description: Returns the cost of bandwidth rental for specified parameters.

Parameters:

  • amount (required) – bandwidth amount (1000, 5000, 10000, 50000, 100000, 500000, 1000000)
  • duration (required) – rental period (1h, 1d, 3d, 1w, 1M)
  • target (optional) – target TRON address

Response: JSON object with price in TRX and rental period information

POST

/bandwidth/rent

Rent bandwidth

+

Description: Creates a bandwidth rental order for the specified TRON address.

Request body parameters:

  • amount – bandwidth amount (integer)
  • duration – rental duration (1h, 1d, 3d, 1w, 1M)
  • target – target TRON address
  • currency – payment currency (TRX, RUB)

Response: JSON object with bandwidth rental order information

GET

/rentals/history

Energy rental history

+

Description: Returns the history of all energy rental operations for your account with pagination.

Parameters:

  • page (optional) – page number (default 1)
  • per_page (optional) – records per page (default 20, maximum 100)

Response: JSON object with operations array and pagination information

Usage Examples

Balance Request Example

curl -H “X-API-Key: YOUR_KEY” \ https://api.telegatron.com/api/v1/balance

Energy Rental Example

curl -X POST -H “X-API-Key: YOUR_KEY” \ -H “Content-Type: application/json” \ -d ‘{“amount”: 65000, “duration”: “1h”, “target”: “TXsmKpEuW7qWnXzJLGP9eDLvWPR2GRn1FS”, “currency”: “TRX”}’ \ https://api.telegatron.com/api/v1/energy/rent

Energy Price Request Example

curl -H “X-API-Key: YOUR_KEY” \ “https://api.telegatron.com/api/v1/energy/price?amount=65000&duration=1h”

Bandwidth Rental Example

curl -X POST -H “X-API-Key: YOUR_KEY” \ -H “Content-Type: application/json” \ -d ‘{“amount”: 1000, “duration”: “1h”, “target”: “TXsmKpEuW7qWnXzJLGP9eDLvWPR2GRn1FS”, “currency”: “TRX”}’ \ https://api.telegatron.com/api/v1/bandwidth/rent

Response Format

All API methods return data in JSON format with appropriate HTTP status codes. In case of error, an object is returned with “success”: false and an “error” field containing the error description.