TronRental API

https://docs.tronrental.com
Admin
TronRental provides a REST API for renting TRON energy and bandwidth to reduce USDT transfer costs.
Tokens:10,132
Snippets:264
Trust Score:3.8
Update:4 months ago
Show doc for...
Tokens:
Raw
### Get Invoice Example

Source: https://docs.tronrental.com/api-reference/invoices/get-invoice

Example of how to fetch invoice details using curl.

```bash
curl https://api.tronrental.com/v1/invoices/12345 \
  -H "X-API-Key: your_api_key"
```

--------------------------------

### Python example for buying energy

Source: https://docs.tronrental.com/quickstart

Programmatically buy TRON energy using Python.

```python
import requests

API_KEY = "your_api_key"
BASE = "https://api.tronrental.com/v1"
headers = {"X-API-Key": API_KEY}

# Buy energy
resp = requests.post(f"{BASE}/energy/buy", headers=headers, json={
    "address": "TRecipientAddress...",
    "energy_amount": 65000,
    "duration_hours": 1,
})
print(resp.json())
```

--------------------------------

### JavaScript example for buying energy

Source: https://docs.tronrental.com/quickstart

Programmatically buy TRON energy using JavaScript.

```javascript
const API_KEY = "your_api_key";
const BASE = "https://api.tronrental.com/v1";

const res = await fetch(`${BASE}/energy/buy`, {
  method: "POST",
  headers: {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    address: "TRecipientAddress...",
    energy_amount: 65000,
    duration_hours: 1,
  }),
});
console.log(await res.json());
```

--------------------------------

### Get Smart Mode Fees - cURL Example

Source: https://docs.tronrental.com/api-reference/smart-mode/get-fees

Example of how to fetch current Smart Mode fees using cURL.

```bash
curl https://api.tronrental.com/v1/smart-mode/fees \
  -H "X-API-Key: your_api_key"
```

--------------------------------

### Deposit TRX

Source: https://docs.tronrental.com/quickstart

Get your deposit address to send TRX or USDT.

```bash
curl https://api.tronrental.com/v1/account/deposit \
  -H "X-API-Key: your_api_key"
```

--------------------------------

### Example Response

Source: https://docs.tronrental.com/api-reference/energy/get-prices

An example of the JSON response structure for the Get Prices endpoint.

```json
{
  "energy_trx": {"1h": "2.32"},
  "energy_sun": {"1h": "35.68"},
  "energy_usd": {"1h": "0.69"},
  "energy_volume": 65000,
  "bandwidth_trx": {"1h": "0.14"},
  "bandwidth_sun": {"1h": "400.00"},
  "bandwidth_usd": {"1h": "0.04"},
  "bandwidth_volume": 350,
  "trx_usd_rate": "0.297",
  "burn_cost_trx": "6.5",
  "burn_cost_usd": "1.93",
  "savings_percent": "64.3",
  "note": "Energy price is for 65,000 units in TRX"
}
```

--------------------------------

### Get Prices using Python

Source: https://docs.tronrental.com/api-reference/energy/get-prices

Example of how to fetch current energy and bandwidth prices using Python.

```python
import requests
resp = requests.get("https://api.tronrental.com/v1/prices")
print(resp.json())
```

--------------------------------

### Get Package Tiers

Source: https://docs.tronrental.com/api-reference/transfer-packages/get-tiers

Example request to fetch available package tiers.

```bash
curl https://api.tronrental.com/v1/transfer-packages/tiers \
  -H "X-API-Key: your_api_key"
```

--------------------------------

### Get Prices using cURL

Source: https://docs.tronrental.com/api-reference/energy/get-prices

Example of how to fetch current energy and bandwidth prices using cURL.

```bash
curl https://api.tronrental.com/v1/prices
```

--------------------------------

### Check prices

Source: https://docs.tronrental.com/quickstart

Fetch current prices for TRON energy and bandwidth.

```bash
curl https://api.tronrental.com/v1/prices
```

```json
{
  "energy_trx": { "1h": "1.79", "1d": "..." },
  "energy_sun": { "1h": "27.54", "1d": "..." },
  "energy_volume": 65000,
  "bandwidth_trx": { "1h": "1.54", "1d": "..." },
  "bandwidth_volume": 350,
  "trx_usd_rate": "0.234",
  "burn_cost_trx": "6.5",
  "savings_percent": "72.5"
}
```

--------------------------------

### Quick example

Source: https://docs.tronrental.com

Example of how to buy energy using the API.

```curl
curl -X POST https://api.tronrental.com/v1/energy/buy \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "TYourTronAddress...",
    "energy_amount": 65000,
    "duration_hours": 1
  }'
```

--------------------------------

### Response Example

Source: https://docs.tronrental.com/api-reference/transfer-packages/get-tiers

Example JSON response for the Get Tiers endpoint.

```json
{
  "tiers": [
    { "size": 100, "price_trx": "270.00" },
    { "size": 500, "price_trx": "1350.00" },
    { "size": 1000, "price_trx": "2700.00" }
  ],
  "single_transfer_price": "2.70",
  "bw_fee_per_transfer": "0.30",
  "min_custom_size": 1,
  "max_custom_size": 10000
}
```

--------------------------------

### Install MCP Server

Source: https://docs.tronrental.com/resources/mcp-server

Install the TronRental MCP server using npx.

```bash
npx -y @tronrental-com/mcp-server
```

--------------------------------

### Invoice Response Example

Source: https://docs.tronrental.com/api-reference/invoices/get-invoice

Example JSON response for a successful invoice retrieval.

```json
{
  "invoice_id": 12345,
  "payment_address": "TPaymentAddress...",
  "address": "TRecipientAddress...",
  "energy_amount": 65000,
  "duration_hours": 1,
  "price_trx": "2.75",
  "price_usdt": "0.64",
  "status": "delegated",
  "tx_hash": "a1b2c3d4e5f6...",
  "paid_at": "2026-03-05T12:05:00Z",
  "delegated_at": "2026-03-05T12:05:30Z",
  "expires_at": "2026-03-05T12:30:00Z",
  "created_at": "2026-03-05T12:00:00Z"
}
```

--------------------------------

### Buy energy

Source: https://docs.tronrental.com/quickstart

Purchase TRON energy for a specified amount and duration.

```bash
curl -X POST https://api.tronrental.com/v1/energy/buy \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ 
    "address": "TRecipientAddress...",
    "energy_amount": 65000,
    "duration_hours": 1
  }'
```

```json
{
  "order_id": 1234,
  "address": "TRecipientAddress...",
  "energy_amount": 65000,
  "duration_hours": 1,
  "price_trx": "2.75",
  "status": "pending"
}
```

--------------------------------

### Verify order status

Source: https://docs.tronrental.com/quickstart

Check the status of your energy purchase order.

```bash
curl https://api.tronrental.com/v1/orders \
  -H "X-API-Key: your_api_key"
```

--------------------------------

### Get Prices using JavaScript

Source: https://docs.tronrental.com/api-reference/energy/get-prices

Example of how to fetch current energy and bandwidth prices using JavaScript.

```javascript
const resp = await fetch("https://api.tronrental.com/v1/prices");
const data = await resp.json();
console.log(data);
```

--------------------------------

### Get Balance API Request

Source: https://docs.tronrental.com/api-reference/account/get-balance

Example cURL command to fetch the account balance.

```bash
curl https://api.tronrental.com/v1/account/balance \
  -H "X-API-Key: your_api_key"
```

--------------------------------

### Response Example

Source: https://docs.tronrental.com/api-reference/transfer-packages/list

This is an example of the JSON response when listing transfer packages.

```json
[
  {
    "id": 101,
    "address": "TYourAddress...",
    "total_transfers": 500,
    "remaining_transfers": 312,
    "bw_guarantee": true,
    "status": "active",
    "created_at": "2026-03-01T10:00:00Z"
  }
]
```

--------------------------------

### Get Smart Mode Fees - JSON Response Example

Source: https://docs.tronrental.com/api-reference/smart-mode/get-fees

Example JSON response showing the current Smart Mode fees.

```json
{
  "subscription_fee_trx": "3.0",
  "transfer_fee_trx": "2.7",
  "bw_fee_trx": "0.3"
}
```

--------------------------------

### List Invoices Example

Source: https://docs.tronrental.com/api-reference/invoices/list-invoices

Example of how to list invoices with query parameters for page and status.

```bash
curl "https://api.tronrental.com/v1/invoices/my?page=1&status=delegated" \
  -H "X-API-Key: your_api_key"
```

--------------------------------

### Response

Source: https://docs.tronrental.com

Example response for a successful energy purchase request.

```json
{
  "order_id": 12345,
  "address": "TYourTronAddress...",
  "energy_amount": 65000,
  "duration_hours": 1,
  "price_trx": "2.75",
  "status": "pending"
}
```

--------------------------------

### Get Balance API Response

Source: https://docs.tronrental.com/api-reference/account/get-balance

Example JSON response showing the account balance.

```json
{
  "balance_trx": "156.50"
}
```

--------------------------------

### Get Profile API Request

Source: https://docs.tronrental.com/api-reference/account/get-profile

Example cURL command to fetch the user's account profile using the Tronrental API.

```bash
curl https://api.tronrental.com/v1/account/profile \
  -H "X-API-Key: your_api_key"
```

--------------------------------

### Get Profile API Response

Source: https://docs.tronrental.com/api-reference/account/get-profile

Example JSON response for the Get Profile API endpoint, detailing user account information.

```json
{
  "id": 1,
  "email": "user@example.com",
  "tron_address": "TYourAddress...",
  "balance_trx": "150.50",
  "totp_enabled": false,
  "created_at": "2026-01-15T10:00:00Z"
}
```

--------------------------------

### List My Packages

Source: https://docs.tronrental.com/api-reference/transfer-packages/list

This example shows how to list all your transfer packages using a curl command.

```bash
curl https://api.tronrental.com/v1/transfer-packages/my \
  -H "X-API-Key: your_api_key"
```

--------------------------------

### Webhook Payload Example

Source: https://docs.tronrental.com/api-reference/webhooks/overview

Example of the JSON payload received for a webhook event.

```json
{
  "event": "order.filled",
  "data": {
    "order_id": 1234,
    "address": "TAddress...",
    "energy_amount": 65000,
    "price_trx": "2.75"
  },
  "timestamp": "2026-03-04T12:00:00Z"
}
```

--------------------------------

### Authentication Error Example

Source: https://docs.tronrental.com/authentication

Authentication errors return HTTP 401.

```json
{
  "detail": "Invalid or missing API key"
}
```

--------------------------------

### Buy Energy Request

Source: https://docs.tronrental.com/api-reference/energy/buy-energy

Example cURL request to buy energy.

```bash
curl -X POST https://api.tronrental.com/v1/energy/buy \
    -H "X-API-Key: your_api_key" \
    -H "Content-Type: application/json" \
    -d '{
      "target_address": "TYourRecipientAddress1234567890abc",
      "volume": 65000,
      "duration": "1h"
    }'
```

--------------------------------

### List Invoices Response Example

Source: https://docs.tronrental.com/api-reference/invoices/list-invoices

Example JSON response for listing invoices, showing invoice details and pagination.

```json
{
  "invoices": [
    {
      "invoice_id": 789,
      "payment_address": "TPaymentAddress...",
      "address": "TRecipientAddress...",
      "energy_amount": 65000,
      "duration_hours": 1,
      "price_trx": "2.75",
      "price_usdt": "0.64",
      "status": "delegated",
      "created_at": "2026-03-05T12:00:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "pages": 1
}
```

--------------------------------

### Buy Energy Response

Source: https://docs.tronrental.com/api-reference/energy/buy-energy

Example response for a successful energy purchase.

```json
{
  "id": 12345,
  "price_trx": "2.75",
  "status": "pending"
}
```

--------------------------------

### Activate Address Request

Source: https://docs.tronrental.com/api-reference/energy/activate-address

Example of how to activate a TRON address using the API.

```bash
curl -X POST https://api.tronrental.com/v1/energy/activate \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"address": "TNewInactiveAddress..."}'
```

--------------------------------

### Activate Smart Mode Request

Source: https://docs.tronrental.com/api-reference/smart-mode/activate

Starts automatic energy delivery for the specified address. The first daily fee is charged immediately.

```bash
curl -X POST https://api.tronrental.com/v1/smart-mode/activate \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "TYourAddress...",
    "label": "Main wallet",
    "bw_guarantee": true
  }'
```

--------------------------------

### Buy Bandwidth Request

Source: https://docs.tronrental.com/api-reference/bandwidth/buy-bandwidth

Example cURL request to buy bandwidth for a TRON address.

```bash
curl -X POST https://api.tronrental.com/v1/bandwidth/buy \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "TTargetAddress...",
    "bandwidth_amount": 1000,
    "duration_hours": 24
  }'
```

--------------------------------

### Webhook Logs Response Example

Source: https://docs.tronrental.com/api-reference/webhooks/events

Example JSON response structure for webhook logs.

```json
[
  {
    "id": 1,
    "event_type": "order.filled",
    "payload": {
      "order_id": 12345,
      "address": "TAddress...",
      "energy_amount": 65000
    },
    "response_status": 200,
    "attempts": 1,
    "created_at": "2026-03-05T12:00:00Z"
  }
]
```

--------------------------------

### Create Invoice Response

Source: https://docs.tronrental.com/api-reference/invoices/create-invoice

Example JSON response when creating an invoice.

```json
{
  "invoice_id": 789,
  "payment_address": "TPaymentAddress...",
  "address": "TRecipientAddress...",
  "energy_amount": 65000,
  "duration_hours": 1,
  "price_trx": "2.75",
  "price_usdt": "0.64",
  "status": "pending",
  "expires_at": "2026-03-05T12:30:00Z"
}
```

--------------------------------

### Buy Bandwidth Response

Source: https://docs.tronrental.com/api-reference/bandwidth/buy-bandwidth

Example JSON response after successfully purchasing bandwidth.

```json
{
  "order_id": 5678,
  "address": "TTargetAddress...",
  "bandwidth_amount": 1000,
  "duration_hours": 24,
  "price_trx": "9.80",
  "status": "pending"
}
```

--------------------------------

### Activate Address Response

Source: https://docs.tronrental.com/api-reference/energy/activate-address

Example response after successfully activating a TRON address.

```json
{
  "success": true,
  "tx_hash": "a1b2c3d4e5f6..."
}
```

--------------------------------

### Buy Energy Request (Python)

Source: https://docs.tronrental.com/api-reference/energy/buy-energy

Example Python request to buy energy.

```python
import requests

resp = requests.post(
    "https://api.tronrental.com/v1/energy/buy",
    headers={"X-API-Key": "your_api_key"},
    json={
        "target_address": "TYourRecipientAddress1234567890abc",
        "volume": 65000,
        "duration": "1h",
    },
)
print(resp.json())
```

--------------------------------

### Buy Energy Request (JavaScript)

Source: https://docs.tronrental.com/api-reference/energy/buy-energy

Example JavaScript request to buy energy.

```javascript
const resp = await fetch("https://api.tronrental.com/v1/energy/buy", {
    method: "POST",
    headers: {
      "X-API-Key": "your_api_key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      target_address: "TYourRecipientAddress1234567890abc",
      volume: 65000,
      duration: "1h",
    }),
  });
  console.log(await resp.json());
```

--------------------------------

### Create Invoice Request

Source: https://docs.tronrental.com/api-reference/invoices/create-invoice

Example cURL request to create a new invoice for energy delegation.

```bash
curl -X POST https://api.tronrental.com/v1/invoices \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "TRecipientAddress...",
    "transfer_count": 1,
    "duration_hours": 1
  }'
```

--------------------------------

### Get Deposit Address

Source: https://docs.tronrental.com/api-reference/account/deposits

Fetches your personal deposit address and accepted currencies.

```bash
curl https://api.tronrental.com/v1/account/deposit \
  -H "X-API-Key: your_api_key"
```

```json
{
  "deposit_address": "TYourDepositAddress...",
  "accepted_currencies": ["TRX", "USDT"],
  "usdt_to_trx_rate": "26.5",
  "trx_usd_rate": "0.234"
}
```

--------------------------------

### Create Withdrawal Response

Source: https://docs.tronrental.com/api-reference/account/withdrawals

Example JSON response after successfully creating a withdrawal.

```json
{
  "id": 56,
  "to_address": "TDestinationAddress...",
  "amount_trx": "100.00",
  "fee_trx": "1.00",
  "status": "completed",
  "tx_hash": "a1b2c3d4e5f6...",
  "created_at": "2026-03-05T12:00:00Z"
}
```

--------------------------------

### Fetch Webhook Logs

Source: https://docs.tronrental.com/api-reference/webhooks/events

Example of how to fetch recent webhook delivery logs using curl.

```bash
curl https://api.tronrental.com/v1/webhooks/logs \
  -H "X-API-Key: your_api_key"
```

--------------------------------

### List Subscriptions API Request

Source: https://docs.tronrental.com/api-reference/smart-mode/list-subscriptions

Example cURL command to fetch active and paused Smart Mode subscriptions.

```bash
curl https://api.tronrental.com/v1/smart-mode/subscriptions \
  -H "X-API-Key: your_api_key"
```

--------------------------------

### API call with retry strategy

Source: https://docs.tronrental.com/errors

Example of implementing exponential backoff for `429` and `5xx` errors.

```python
import time
import requests

def api_call_with_retry(url, **kwargs):
    for attempt in range(3):
        resp = requests.get(url, **kwargs)
        if resp.status_code == 429 or resp.status_code >= 500:
            time.sleep(2 ** attempt)
            continue
        return resp
    raise Exception("Max retries exceeded")
```

--------------------------------

### List Withdrawals Response

Source: https://docs.tronrental.com/api-reference/account/withdrawals

Example JSON response containing a list of past withdrawals.

```json
[
  {
    "id": 56,
    "to_address": "TDestinationAddress...",
    "amount_trx": "100.00",
    "fee_trx": "1.00",
    "status": "completed",
    "tx_hash": "a1b2c3d4e5f6...",
    "created_at": "2026-03-05T12:00:00Z"
  }
]
```

--------------------------------

### List Withdrawals Request

Source: https://docs.tronrental.com/api-reference/account/withdrawals

Example cURL request to retrieve the withdrawal history for the account.

```bash
curl https://api.tronrental.com/v1/account/withdrawals \
  -H "X-API-Key: your_api_key"
```

--------------------------------

### List Subscriptions API Response

Source: https://docs.tronrental.com/api-reference/smart-mode/list-subscriptions

Example JSON response showing active and paused Smart Mode subscriptions.

```json
[
  {
    "id": 42,
    "address": "TYourAddress...",
    "label": "Main wallet",
    "status": "active",
    "bw_guarantee": true,
    "created_at": "2026-03-05T12:00:00Z"
  },
  {
    "id": 43,
    "address": "TAnotherAddress...",
    "label": null,
    "status": "paused",
    "bw_guarantee": false,
    "created_at": "2026-03-04T10:00:00Z"
  }
]
```

--------------------------------

### Create Withdrawal Request

Source: https://docs.tronrental.com/api-reference/account/withdrawals

Example cURL request to create a TRX withdrawal to a specified TRON address.

```bash
curl -X POST https://api.tronrental.com/v1/account/withdrawal \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "to_address": "TDestinationAddress...",
    "amount_trx": "100"
  }'
```

--------------------------------

### Response

Source: https://docs.tronrental.com/api-reference/webhooks/configure

Successful response after configuring the webhook.

```json
{
  "url": "https://yourserver.com/webhook/tronrental",
  "secret": "whsec_abc123...",
  "active": true,
  "created_at": "2026-03-05T12:00:00Z"
}
```

--------------------------------

### Activate Smart Mode Response

Source: https://docs.tronrental.com/api-reference/smart-mode/activate

Returns the created subscription object with `id`, `address`, `status`, and fee details.

```json
{
  "id": 42,
  "address": "TYourAddress...",
  "label": "Main wallet",
  "status": "active",
  "bw_guarantee": true,
  "subscription_fee_trx": "3.0",
  "transfer_fee_trx": "2.7",
  "created_at": "2026-03-05T12:00:00Z"
}
```

--------------------------------

### Configure Webhook

Source: https://docs.tronrental.com/api-reference/webhooks/configure

Sets or updates your webhook URL.

```bash
curl -X POST https://api.tronrental.com/v1/webhooks/configure \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://yourserver.com/webhook/tronrental"}'
```

--------------------------------

### Response

Source: https://docs.tronrental.com/api-reference/smart-mode/toggle

Returns the updated subscription object with new `status`.

```json
{
  "id": 42,
  "address": "TYourAddress...",
  "label": "Main wallet",
  "status": "paused",
  "bw_guarantee": true,
  "created_at": "2026-03-05T12:00:00Z"
}
```

--------------------------------

### Buy Transfer Package Request

Source: https://docs.tronrental.com/api-reference/transfer-packages/buy

Purchases a transfer package using your account balance.

```bash
curl -X POST https://api.tronrental.com/v1/transfer-packages/buy \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "TYourAddress...",
    "size": 500,
    "bw_guarantee": true
  }'
```

--------------------------------

### List Deposits

Source: https://docs.tronrental.com/api-reference/account/deposits

Retrieves your deposit history.

```bash
curl https://api.tronrental.com/v1/account/deposits \
  -H "X-API-Key: your_api_key"
```

--------------------------------

### Buy Transfer Package Response

Source: https://docs.tronrental.com/api-reference/transfer-packages/buy

Returns the created package object with `id`, `address`, `remaining_transfers`, `status`, and `price_trx`.

```json
{
  "id": 101,
  "address": "TYourAddress...",
  "total_transfers": 500,
  "remaining_transfers": 500,
  "bw_guarantee": true,
  "price_trx": "1350.00",
  "status": "active",
  "created_at": "2026-03-05T12:00:00Z"
}
```

--------------------------------

### Base URL

Source: https://docs.tronrental.com

All API requests use the following base URL.

```text
https://api.tronrental.com/v1
```

--------------------------------

### MCP Configuration for Cursor / Windsurf

Source: https://docs.tronrental.com/resources/mcp-server

Configure the TronRental MCP server in your MCP configuration file for Cursor or Windsurf.

```json
{
  "mcpServers": {
    "tronrental": {
      "command": "npx",
      "args": ["-y", "@tronrental-com/mcp-server"],
      "env": {
        "TRONRENTAL_API_KEY": "your_key"  // pragma: allowlist secret
      }
    }
  }
}
```

--------------------------------

### Toggle Subscription

Source: https://docs.tronrental.com/api-reference/smart-mode/toggle

Pauses an active subscription or resumes a paused one. While paused, no fees are charged and transfers are not monitored.

```bash
curl -X POST https://api.tronrental.com/v1/smart-mode/42/toggle \
  -H "X-API-Key: your_api_key"
```

--------------------------------

### Add MCP Server to Claude Code (with API key)

Source: https://docs.tronrental.com/resources/mcp-server

Add the TronRental MCP server to Claude Code with an API key.

```bash
# With API key
claude mcp add tronrental -e TRONRENTAL_API_KEY=your_key -- npx -y @tronrental-com/mcp-server
```

--------------------------------

### Error format with detail field

Source: https://docs.tronrental.com/errors

All errors return a JSON response with a `detail` field.

```json
{
  "detail": "Insufficient balance"
}
```

--------------------------------

### Add MCP Server to Claude Code (without API key)

Source: https://docs.tronrental.com/resources/mcp-server

Add the TronRental MCP server to Claude Code without an API key, allowing for automatic agent registration.

```bash
# Without API key (agent will register automatically)
claude mcp add tronrental -- npx -y @tronrental-com/mcp-server
```

--------------------------------

### Rate Limit Headers

Source: https://docs.tronrental.com/resources/rate-limits

Responses include rate limit information in headers.

```text
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1709568000
```

--------------------------------

### Error format with structured code

Source: https://docs.tronrental.com/errors

Some errors include a structured `code` for programmatic handling.

```json
{
  "detail": {
    "error": {
      "code": "INSUFFICIENT_BALANCE",
      "message": "Not enough TRX balance"
    }
  }
}
```

--------------------------------

### Verify Webhook Signature (Python)

Source: https://docs.tronrental.com/api-reference/webhooks/overview

Python function to verify the HMAC-SHA256 signature of an incoming webhook request.

```python
import hmac
import hashlib

def verify_webhook(payload: bytes, signature: str, secret: str) -> bool:
    expected = hmac.new(
        secret.encode(),
        payload,
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(expected, signature)

# In your webhook handler:
# payload = request.body  (raw bytes)
# signature = request.headers["X-Webhook-Signature"]
# secret = "whsec_abc123..."  (from configure response)
# if not verify_webhook(payload, signature, secret):
#     return Response(status_code=401)
```

--------------------------------

### Response

Source: https://docs.tronrental.com/api-reference/smart-mode/deactivate

Returns the deactivated subscription object.

```json
{
  "id": 42,
  "address": "TYourAddress...",
  "status": "deactivated",
  "message": "Subscription permanently deactivated"
}
```

--------------------------------

### Verify Webhook Signature (JavaScript)

Source: https://docs.tronrental.com/api-reference/webhooks/overview

JavaScript function to verify the HMAC-SHA256 signature of an incoming webhook request.

```javascript
const crypto = require("crypto");

function verifyWebhook(payload, signature, secret) {
  const expected = crypto
    .createHmac("sha256", secret)
    .update(payload)
    .digest("hex");
  return crypto.timingSafeEqual(
    Buffer.from(expected),
    Buffer.from(signature)
  );
}

// In your webhook handler:
// const payload = req.rawBody;  // raw request body string
// const signature = req.headers["x-webhook-signature"];
// const secret = "whsec_abc123...";
// if (!verifyWebhook(payload, signature, secret)) {
//   return res.status(401).send("Invalid signature");
// }
```

--------------------------------

### TRX burned without energy

Source: https://docs.tronrental.com/resources/tron-energy

Calculates the TRX cost when energy is not available and TRX is burned instead.

```text
64,285 energy × 100 SUN/energy = 6,428,500 SUN = 6.43 TRX
```

--------------------------------

### Exceeding Limits Response

Source: https://docs.tronrental.com/resources/rate-limits

When rate limited, you'll receive HTTP 429 with a JSON response detailing the error.

```json
{
  "detail": "Rate limit exceeded. Try again in 30 seconds."
}
```

--------------------------------

### Deactivate Subscription

Source: https://docs.tronrental.com/api-reference/smart-mode/deactivate

Permanently deactivates a Smart Mode subscription. This action cannot be undone — you'll need to create a new subscription to re-enable.

```bash
curl -X POST https://api.tronrental.com/v1/smart-mode/42/deactivate \
  -H "X-API-Key: your_api_key"
```
Tokens:
Raw