> For the complete documentation index, see [llms.txt](https://savefee.gitbook.io/savefee/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://savefee.gitbook.io/savefee/introduction.md).

# Introduction

SaveFee sells TRON **energy** on demand. You place an order, SaveFee delegates energy to the address you name, and your account balance is debited in `sun`.

Renting the resource this way typically costs **65–70% less** than burning TRX for the same transaction on-chain.

## What you can do

| Capability                  | Summary                                                                                                                           |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **Buy energy**              | Delegate 50,000–200,000 ENERGY to any activated TRON address, for 1, 5, 15 or 60 minutes.                                         |
| **Broadcast a transaction** | Sign a transaction yourself — a USDT transfer, another contract call. SaveFee provisions the resource it needs and broadcasts it. |
| **Receive webhooks**        | Get notified when an order is created, and again when the energy has landed.                                                      |

## Base URL

```
https://api.savefee.io
```

Every endpoint is versioned under `/v1`. Requests and responses are JSON. Errors follow [RFC 7807](https://datatracker.ietf.org/doc/html/rfc7807).

## Authentication in one line

Every partner endpoint takes your API key as a bearer token:

```
Authorization: Bearer sf_live_…
```

## Before your first call

You need three things:

1. **An account**, created from the SaveFee dashboard.
2. **An API key**, minted from the dashboard. It starts with `sf_live_`.
3. **A funded balance**. Energy is paid for from a prepaid balance held in `sun`.

All three are covered in **Onboarding**. If you already have them, go straight to the **Quickstart**.

## Units

Every amount in this API is an integer number of **`sun`**. There is no decimal type anywhere in the API.

```
1 TRX = 1,000,000 sun
```

{% hint style="info" %}
SaveFee does not publish a fixed price list — the unit price moves with the market. Quote from the live table at `GET /v1/public/pricing`, and use `totalCostSun` from the response as the amount you were charged rather than recomputing it from a price you stored.
{% endhint %}