> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tronrental.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Buy TRON energy in under 5 minutes

## 1. Get your API key

Sign up and create an API key at [tronrental.com/dashboard/api](https://tronrental.com/dashboard/api).

## 2. Check prices

```bash theme={null}
curl https://api.tronrental.com/v1/prices
```

```json theme={null}
{
  "energy_trx": { "1h": "1.79" },
  "energy_sun": { "1h": "27.54" },
  "energy_volume": 65000,
  "energy_fixed_fee_trx": "0.2",
  "bandwidth_trx": { "1h": "0.34", "1d": "0.42" },
  "bandwidth_sun": { "1h": "400", "1d": "630" },
  "bandwidth_volume": 350,
  "trx_usd_rate": "0.234",
  "burn_cost_trx": "6.5",
  "savings_percent": "72.5"
}
```

Energy rental is **1 hour only** (`"1h"`). Bandwidth supports `"1h"` or `"1d"`. `energy_trx` is rental only — add `energy_fixed_fee_trx` (0.2 TRX) at checkout.

## 3. Deposit TRX

Check your deposit address:

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

Send TRX or USDT to the returned `deposit_address`. Deposits are credited automatically.

## 4. Buy energy

```bash theme={null}
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"
  }'
```

```json theme={null}
{
  "id": 12345,
  "price_trx": "2.75",
  "status": "pending",
  "txid": null,
  "reclaim_at": null,
  "activation_cost_trx": "0"
}
```

The energy will be delegated to the target address within seconds.

## 5. Verify

Check your order status:

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

```json theme={null}
{
  "orders": [
    {
      "id": 12345,
      "type": "energy",
      "target_address": "TYourRecipientAddress1234567890abc",
      "volume": 65000,
      "duration": "1h",
      "price_trx": "2.75",
      "status": "filled",
      "delegate_txid": "abc123...",
      "reclaim_at": null,
      "source": "api",
      "created_at": "2026-06-09T12:00:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "page_size": 50
}
```

<Tip>
  **65,000 energy** is enough for one USDT transfer to an address that already holds USDT.
  For first-time USDT recipients, use **131,000 energy**.
</Tip>

## Code examples

<CodeGroup>
  ```python Python theme={null}
  import requests

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

  resp = requests.post(
      f"{BASE}/energy/buy",
      headers=headers,
      json={
          "target_address": "TYourRecipientAddress1234567890abc",
          "volume": 65000,
          "duration": "1h",
      },
  )
  print(resp.json())
  ```

  ```javascript JavaScript theme={null}
  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({
      target_address: "TYourRecipientAddress1234567890abc",
      volume: 65000,
      duration: "1h",
    }),
  });
  console.log(await res.json());
  ```
</CodeGroup>
