> 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/api-reference/get-v1-public-pricing.md).

# GET /v1/public/pricing

The prices `POST /v1/orders` charges, as they stand right now. SaveFee does not publish a fixed price list — every unit price is derived from a base price that moves with the market — so read this endpoint at runtime instead of hard-coding a table.

Across the tiers, renting energy here typically costs **65–70% less** than burning TRX for the same resource on-chain.

## Request

```bash
curl https://api.savefee.io/v1/public/pricing
```

No authentication, no parameters.

## Response `200`

The numbers below illustrate the shape of the response. They are **not a quote** — always read the current figures from the endpoint itself.

```json
{
  "resource": "ENERGY",
  "baseUnitPriceSun": 25,
  "amountMin": 50000,
  "amountMax": 200000,
  "tiers": [
    { "durationSec": 60,   "label": "1m",  "unitPriceSun": 25 },
    { "durationSec": 300,  "label": "5m",  "unitPriceSun": 25 },
    { "durationSec": 900,  "label": "15m", "unitPriceSun": 27 },
    { "durationSec": 3600, "label": "1h",  "unitPriceSun": 28 }
  ]
}
```

| Field                     | Description                                   |
| ------------------------- | --------------------------------------------- |
| `resource`                | The resource these prices apply to.           |
| `baseUnitPriceSun`        | The base price every tier is derived from.    |
| `amountMin` / `amountMax` | The `amount` range `POST /v1/orders` accepts. |
| `tiers[].durationSec`     | A value you may send as `durationSec`.        |
| `tiers[].unitPriceSun`    | Price per unit of energy for that duration.   |

```
totalCostSun = amount × unitPriceSun
```

## How to use it

* **Quote from this endpoint**, not from a table stored in your code. It needs no key, so it is cheap to call and easy to cache for a few minutes.
* **Accept new tiers.** `tiers` can grow — read the list rather than hard-coding the durations you know about today.
* **Reconcile from the order.** `totalCostSun` in the `201` response is the amount you were charged, and is what your accounting should use.