# Rent Tron energy for an address

`POST /v1/payment/tron-energy/rent`

Rents Tron energy for the specified address, deducting the cost from the user's balance. The cost is determined by the current TRX price and the amount of energy required (5 TRX for 65000 energy or 10 TRX for 131000 energy).

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `api` | query | string | required | Your [WAXPEER API](https://waxpeer.com/profile/user) |

## Request body

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `address` | string | required | Tron wallet address to rent energy for |

```json
{
  "address": "TJnmJPpsbmfaLPmkxWz5EXKxUCtzdGSvcT"
}
```

## Example (curl)

```bash
curl -X POST 'https://api.waxpeer.com/v1/payment/tron-energy/rent?api=%7B%7BAPI_KEY%7D%7D' \
  -H 'Content-Type: application/json' \
  -d '{
  "address": "TJnmJPpsbmfaLPmkxWz5EXKxUCtzdGSvcT"
}'
```

## Example response

```json
{
  "success": true,
  "address": "TJnmJPpsbmfaLPmkxWz5EXKxUCtzdGSvcT",
  "total_cost": 1170,
  "msg": "Successfully rented Tron energy for 1.17 USD (5 TRX)"
}
```

## Responses

- `200` successful operation

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `success` | boolean | optional |  |
| `address` | string | optional | Tron wallet address that energy was rented for |
| `total_cost` | number | optional | Amount deducted from user balance in cents |
| `msg` | string | optional | Success or error message |


## Notes for agents

- Auth is the query parameter `api`, not an Authorization header.
- See [/statuses.md](/statuses.md) for numeric trade status plus `escrow_status` / `release_date`.
- Prefer GET /v2/search-items-by-name over v1.
- Prefer GET /v2/get-items-list over v1 (cursor keyset pagination without the 5000 row cap). Pass next_cursor only while has_more is true.
- Prefer POST /v2/my-history over v1 (faster on long histories, ordered by trade id). On buy rows, price is the amount you paid.
- Trade-locked listings are omitted unless you pass include_hold=1. They then include unlock_at and send_until (RFC 3339 UTC).
- Buy a trade-locked listing only by exact item_id with allow_trade_locked (query 1 on GET /v1/buy-one-p2p, body true on POST /v1/buy). GET /v1/buy-one-p2p-name never sells hold items.
- CSV snapshot: GET /v1/prices/snapshot?format=csv (gzip). include_hold appends unlock_at,send_until. compact and whitemarket are JSON-only.
- Do not use GET /v1/ready-to-transfer-p2p; use the [trade websocket](/websocket.md).