# GetGas Energy API

Buy TRON Energy and Bandwidth for any address from your GetGas balance — once, or automatically — so USDT (TRC-20) transfers cost a fraction of the TRX they would otherwise burn.
Version d749d802fff1, updated 2026-09-29.

- **Base URL:** `https://getgas.io/api/v1`
- **Format:** JSON requests and responses, UTF-8. Successful responses are `{"data": ...}`, errors are `{"error": {"code", "message", "details"?}}`.
- **Authentication:** `Authorization: Bearer <API key>`
- **Money:** amounts are integers in sun (1 TRX = 1,000,000 sun), with an exact decimal TRX string alongside.
- **Rate limits:** 120 requests per minute per key; 30 new orders per minute per account.
- **This reference:** `GET https://getgas.io/api/v1/docs`, no key needed. It is generated from the same code as the API, so it always describes what is deployed. Compare the `X-Docs-Version` header with the version you last read to know when to read it again.

## Contents

1. Getting started
2. Endpoints overview
3. Endpoints
4. Order fields
5. Automation fields
6. Objects
7. Order statuses
8. Prices and final price
9. Automations
10. Idempotency and retries
11. Errors
12. JavaScript example
13. Changelog

## 1. Getting started

1. **Create an account** at https://getgas.io/signup and an API key in the dashboard: Settings → API keys (https://getgas.io/dashboard/settings). The key is shown once; store it in an environment variable, never in client-side code. Anyone holding it can spend your balance, so revoke a leaked key right away.
2. **Top up the balance:** `GET /account` returns your deposit address. Send TRX or USDT (TRC-20) to it; the balance is credited once the payment confirms.
3. **Buy Energy:** `POST /orders` with the receiving address, the volume and the term. The price is taken from the balance. For an address that has never been used, check it first with `GET /addresses/{address}` and activate it if needed.
4. **Wait for delivery:** poll `GET /orders/{id}` until the status is `filled`. Then send the USDT transfer from that address: it uses the delegated Energy instead of burning TRX.

```bash
curl https://getgas.io/api/v1/account -H "Authorization: Bearer ggk_xxxxxxxxxx_..."
```

## 2. Endpoints overview

| Method | Path | What it does |
| --- | --- | --- |
| GET | `/api/v1/docs` | This reference as Markdown, always matching the deployed API. |
| GET | `/api/v1/prices` | Current prices and order limits. |
| GET | `/api/v1/account` | Balance, the deposit address for topping it up, and this account's prices. |
| GET | `/api/v1/deposits` | Payments received at the deposit address, newest first. |
| POST | `/api/v1/orders` | Buy Energy or Bandwidth for any TRON address, paid from the balance. |
| GET | `/api/v1/orders` | Orders on this account, newest first. |
| GET | `/api/v1/orders/{id}` | One order, with its current status. |
| GET | `/api/v1/addresses/{address}` | Whether an address exists on-chain, and what activating it costs. |
| POST | `/api/v1/addresses/{address}/activate` | Activate a new address, paid from the balance. |
| GET | `/api/v1/automations` | This account's automations (not removed), newest first. |
| POST | `/api/v1/automations` | Start auto-refill, auto-renewal or smart mode on an address. |
| GET | `/api/v1/automations/{id}` | One automation. |
| POST | `/api/v1/automations/{id}/pause` | Pause an automation. |
| POST | `/api/v1/automations/{id}/resume` | Resume a paused automation. |
| DELETE | `/api/v1/automations/{id}` | Remove an automation for good. |
| GET | `/api/v1/deliveries` | Deliveries made by automations, newest first, with what each cost. |

## 3. Endpoints

### GET `/api/v1/docs`

This reference as Markdown, always matching the deployed API.

No API key needed. Every response carries an X-Docs-Version header and an ETag, so a request with If-None-Match returns 304 while nothing has changed. The "Changelog" section lists what changed and when.

**Authentication:** not required.

**Success:** 200 OK — Markdown (`text/markdown`). 304 Not Modified when If-None-Match matches.

**Example**

```bash
curl https://getgas.io/api/v1/docs
curl -sI https://getgas.io/api/v1/docs | grep -i x-docs-version
```

---

### GET `/api/v1/prices`

Current prices and order limits.

No API key needed. These follow the network price and are refreshed every few minutes, so read them before quoting a price to a user. Rates are sun per unit; an order costs volume × rate. An account with its own rates sees them in GET /account.

**Authentication:** not required.

**Success:** 200 OK — `{"data": {"currency": "TRX", "updatedAt", "energy": {"minVolume", "maxVolume", "terms": [{"term", "label", "sunPerUnit"}]}, "bandwidth": {"minVolume", "maxVolume", "sunPerUnit"}, "smartDeliverySun", "activationSun", "usdtTransfer": {"energyToHolder", "energyToNewHolder"}}}`

**Example**

```bash
curl https://getgas.io/api/v1/prices
```

---

### GET `/api/v1/account`

Balance, the deposit address for topping it up, and this account's prices.

The deposit address is permanent and belongs to this account: send TRX or USDT (TRC-20) to it and the balance is credited after the payment confirms, usually within a few minutes. Poll this endpoint or GET /deposits to see it arrive.

**Authentication:** API key.

**Success:** 200 OK — `{"data": Account}`

**Errors:** `401 unauthorized`, `429 rate_limited`

**Example**

```bash
curl https://getgas.io/api/v1/account -H "Authorization: Bearer $GETGAS_API_KEY"
```

---

### GET `/api/v1/deposits`

Payments received at the deposit address, newest first.

Includes payments that are still confirming (creditedAt is null).

**Authentication:** API key.

**Query parameters**

| Name | Description |
| --- | --- |
| `limit` | 1–100, default 25. |
| `offset` | Items to skip, default 0. |

**Success:** 200 OK — `{"data": [Deposit, ...]}`

**Errors:** `400 invalid_query`, `401 unauthorized`, `429 rate_limited`

**Example**

```bash
curl "https://getgas.io/api/v1/deposits?limit=10" -H "Authorization: Bearer $GETGAS_API_KEY"
```

---

### POST `/api/v1/orders`

Buy Energy or Bandwidth for any TRON address, paid from the balance.

The price is charged when the order is accepted. The response is the order: "submitted" means it is on its way, usually filled within a minute; poll GET /orders/{id} until the status is final. If the network refuses it, the order comes back "refunded" and the money is already back on the balance. Retrying with the same Idempotency-Key never buys twice: it returns the first order.

**Authentication:** API key.

**Headers**

| Name | Description |
| --- | --- |
| `Idempotency-Key` | Required. A unique string per purchase (8–64 of A–Z a–z 0–9 - _), e.g. a UUID. Reuse it when retrying the same purchase; use a new one for a new purchase. |

**Request body:** JSON object with the fields in "Order fields".

**Success:** 201 Created — `{"data": Order}` for a new order. 200 OK — `{"data": Order}` when the Idempotency-Key was already used for the same order.

**Errors:** `400 invalid_idempotency_key`, `400 invalid_json`, `401 unauthorized`, `402 insufficient_funds`, `409 idempotency_conflict`, `415 unsupported_media_type`, `422 validation_failed`, `422 volume_out_of_range`, `429 rate_limited`, `503 provider_unavailable`

**Example**

```bash
curl -X POST https://getgas.io/api/v1/orders -H "Authorization: Bearer $GETGAS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"address": "TXYZ...your-address...", "volume": 65000, "term": "1h"}'
```

---

### GET `/api/v1/orders`

Orders on this account, newest first.

Includes orders placed on the website.

**Authentication:** API key.

**Query parameters**

| Name | Description |
| --- | --- |
| `limit` | 1–100, default 25. |
| `offset` | Items to skip, default 0. |

**Success:** 200 OK — `{"data": [Order, ...]}`

**Errors:** `400 invalid_query`, `401 unauthorized`, `429 rate_limited`

**Example**

```bash
curl "https://getgas.io/api/v1/orders?limit=10" -H "Authorization: Bearer $GETGAS_API_KEY"
```

---

### GET `/api/v1/orders/{id}`

One order, with its current status.

Checks delivery with the network while the order is "submitted", so polling this is how an order reaches "filled". Poll every few seconds, not faster.

**Authentication:** API key.

**Success:** 200 OK — `{"data": Order}`

**Errors:** `401 unauthorized`, `404 not_found`, `429 rate_limited`

**Example**

```bash
curl https://getgas.io/api/v1/orders/123 -H "Authorization: Bearer $GETGAS_API_KEY"
```

---

### GET `/api/v1/addresses/{address}`

Whether an address exists on-chain, and what activating it costs.

A brand-new address that has never received anything does not exist on-chain yet, and resources cannot be delegated to it. Check before buying for an address you have not used before.

**Authentication:** API key.

**Success:** 200 OK — `{"data": AddressCheck}`

**Errors:** `401 unauthorized`, `422 validation_failed`, `429 rate_limited`, `503 provider_unavailable`

**Example**

```bash
curl https://getgas.io/api/v1/addresses/TXYZ...your-address... -H "Authorization: Bearer $GETGAS_API_KEY"
```

---

### POST `/api/v1/addresses/{address}/activate`

Activate a new address, paid from the balance.

Safe to retry: an address that is already activated is never charged again, and the answer is then its AddressCheck (200). The price is the network's own activation fee.

**Authentication:** API key.

**Success:** 201 Created — `{"data": Activation}`. 200 OK — `{"data": AddressCheck}` when it was already activated.

**Errors:** `401 unauthorized`, `402 insufficient_funds`, `422 validation_failed`, `429 rate_limited`, `503 provider_unavailable`

**Example**

```bash
curl -X POST https://getgas.io/api/v1/addresses/TXYZ...your-address.../activate -H "Authorization: Bearer $GETGAS_API_KEY"
```

---

### GET `/api/v1/automations`

This account's automations (not removed), newest first.

Includes automations created on the website.

**Authentication:** API key.

**Success:** 200 OK — `{"data": [Automation, ...]}`

**Errors:** `401 unauthorized`, `429 rate_limited`

**Example**

```bash
curl https://getgas.io/api/v1/automations -H "Authorization: Bearer $GETGAS_API_KEY"
```

---

### POST `/api/v1/automations`

Start auto-refill, auto-renewal or smart mode on an address.

The balance must cover at least one delivery to start. Each delivery is then charged from the balance as it happens — see "Automations".

**Authentication:** API key.

**Request body:** JSON object with the fields in "Automation fields".

**Success:** 201 Created — `{"data": Automation}`

**Errors:** `400 invalid_json`, `401 unauthorized`, `402 insufficient_funds`, `409 automation_exists`, `415 unsupported_media_type`, `422 validation_failed`, `429 rate_limited`, `503 provider_unavailable`

**Example**

```bash
curl -X POST https://getgas.io/api/v1/automations -H "Authorization: Bearer $GETGAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind": "refill", "address": "TXYZ...your-address...", "volume": 131000, "minimal": 65000, "term": "1h"}'
```

---

### GET `/api/v1/automations/{id}`

One automation.

Removed automations are still returned here, with status "removed".

**Authentication:** API key.

**Success:** 200 OK — `{"data": Automation}`

**Errors:** `401 unauthorized`, `404 not_found`, `429 rate_limited`

**Example**

```bash
curl https://getgas.io/api/v1/automations/7 -H "Authorization: Bearer $GETGAS_API_KEY"
```

---

### POST `/api/v1/automations/{id}/pause`

Pause an automation.

No deliveries until it is resumed. A pause made here is never lifted automatically.

**Authentication:** API key.

**Success:** 200 OK — `{"data": Automation}`

**Errors:** `401 unauthorized`, `404 not_found`, `429 rate_limited`, `503 provider_unavailable`

**Example**

```bash
curl -X POST https://getgas.io/api/v1/automations/7/pause -H "Authorization: Bearer $GETGAS_API_KEY"
```

---

### POST `/api/v1/automations/{id}/resume`

Resume a paused automation.

The balance must cover the next delivery.

**Authentication:** API key.

**Success:** 200 OK — `{"data": Automation}`

**Errors:** `401 unauthorized`, `402 insufficient_funds`, `404 not_found`, `429 rate_limited`, `503 provider_unavailable`

**Example**

```bash
curl -X POST https://getgas.io/api/v1/automations/7/resume -H "Authorization: Bearer $GETGAS_API_KEY"
```

---

### DELETE `/api/v1/automations/{id}`

Remove an automation for good.

Deliveries already made stay billed and listed.

**Authentication:** API key.

**Success:** 200 OK — `{"data": Automation}` with status "removed".

**Errors:** `401 unauthorized`, `404 not_found`, `429 rate_limited`, `503 provider_unavailable`

**Example**

```bash
curl -X DELETE https://getgas.io/api/v1/automations/7 -H "Authorization: Bearer $GETGAS_API_KEY"
```

---

### GET `/api/v1/deliveries`

Deliveries made by automations, newest first, with what each cost.

One row per delivery, charged once.

**Authentication:** API key.

**Query parameters**

| Name | Description |
| --- | --- |
| `limit` | 1–100, default 25. |
| `offset` | Items to skip, default 0. |

**Success:** 200 OK — `{"data": [Delivery, ...]}`

**Errors:** `400 invalid_query`, `401 unauthorized`, `429 rate_limited`

**Example**

```bash
curl "https://getgas.io/api/v1/deliveries?limit=10" -H "Authorization: Bearer $GETGAS_API_KEY"
```

## 4. Order fields

Accepted by `POST /orders`. Unknown fields are rejected with `validation_failed`.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `resource` | string | no | "energy" (default) or "bandwidth". Bandwidth: 350–100,000 per order; one plain transfer needs about 350. |
| `address` | string | yes | TRON address that receives the Energy (starts with T, 34 characters). It does not have to be yours. |
| `volume` | integer | yes | Amount of the resource. Energy: 65,000–5,000,000. One USDT transfer to an address that already holds USDT needs about 65,000; to an address that has never held USDT, about 131,000. |
| `term` | string | yes | How long the resource stays delegated: "15m" or "1h" or "1d". |

## 5. Automation fields

Accepted by `POST /automations`. Only the fields that apply to the `kind` are accepted; anything else is rejected with `validation_failed`.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `kind` | string | yes | "refill", "renewal" or "smart". See "Automations". |
| `address` | string | yes | TRON address to keep supplied. |
| `volume` | integer | no | refill: Energy added each time, 65,000–5,000,000. renewal: Energy kept on the address, 65,000–1,000,000. Not used by smart (always 131,000). |
| `minimal` | integer | no | refill only: add Energy when the address has less than this, 0–5,000,000. |
| `term` | string | no | refill only: how long each delivery lasts, "1h" or "1d". |

## 6. Objects

### Order

| Field | Type | Description |
| --- | --- | --- |
| `id` | integer | Order id. |
| `status` | string | See "Order statuses". |
| `resource` | string | "energy". Orders placed on the website may also be "bandwidth". |
| `address` | string | Address the resource is delegated to. |
| `volume` | integer | Amount of the resource. |
| `term` | string | "15m", "1h" or "1d". |
| `priceSun` | integer | What the order cost, in sun (1 TRX = 1,000,000 sun). |
| `priceTrx` | string | The same price as an exact decimal TRX string, e.g. "2.73". |
| `txId` | string \| null | TRON transaction that delegated the resource, once known. |
| `createdAt` | string | ISO 8601 timestamp. |
| `updatedAt` | string | ISO 8601 timestamp of the last status change. |

### Account

| Field | Type | Description |
| --- | --- | --- |
| `email` | string | The account the key belongs to. |
| `balanceSun` | integer | Balance in sun. Orders are paid from it. |
| `balanceTrx` | string | The same balance as an exact decimal TRX string. |
| `depositAddress` | string \| null | Your permanent TRC-20 address for topping up the balance. Null only if it could not be issued right now; try again later. |
| `depositNetwork` | string | "TRC20". Send only on the TRON network. |
| `depositCurrencies` | string[] | What the deposit address accepts: TRX and USDT (TRC-20). USDT is converted to TRX at the rate when it is credited. |
| `rates` | object | What this account pays now: `energySunPerUnit` by term, `bandwidthSunPerUnit`, `smartDeliverySun` and `activationSun`. Accounts with their own rates see them here. |

### Deposit

| Field | Type | Description |
| --- | --- | --- |
| `id` | integer | Deposit id. |
| `transactionId` | string | TRON transaction hash of the payment. |
| `currency` | string | "TRX" or "USDT-TRC20". |
| `amount` | string | Amount sent, as a decimal string. |
| `netAmount` | string | Amount after the payment network fee, as a decimal string. |
| `creditedSun` | integer | What was added to the balance, in sun. 0 until credited. |
| `status` | string | "confirmed" once credited; other values mean it is still pending, or "ignored" when it needs a manual check (wrong network or currency). |
| `receivedAt` | string | ISO 8601 timestamp. |
| `creditedAt` | string \| null | When the balance was credited. |

### Automation

| Field | Type | Description |
| --- | --- | --- |
| `id` | integer | Automation id. |
| `kind` | string | "refill", "renewal" or "smart". |
| `status` | string | "active", "paused" or "removed". |
| `pauseReason` | string \| null | "system" when paused because the balance could not cover the next delivery, "user" when paused on request. |
| `autoResume` | boolean | Whether a "system" pause ends by itself once the balance covers the next delivery again. |
| `address` | string | Address kept supplied. |
| `volume` | integer | Energy per delivery. |
| `minimal` | integer \| null | refill: the threshold that triggers a delivery. |
| `term` | string \| null | refill: how long each delivery lasts. |
| `nextDeliverySun` | integer | What the next delivery is expected to cost: the balance the rule needs to keep running. |
| `deliveries` | integer | Deliveries made so far. |
| `lastDeliveryAt` | string \| null | ISO 8601 timestamp of the last delivery. |
| `createdAt` | string | ISO 8601 timestamp. |

### Delivery

| Field | Type | Description |
| --- | --- | --- |
| `id` | integer | Delivery id. |
| `automationId` | integer \| null | The automation that made it. |
| `kind` | string \| null | "refill", "renewal" or "smart". |
| `address` | string \| null | Address it was delivered to. |
| `volume` | integer | Energy delivered. |
| `chargedSun` | integer | What it cost the balance, in sun. |
| `chargedTrx` | string | The same as an exact decimal TRX string. |
| `txId` | string \| null | TRON transaction of the delegation. |
| `deliveredAt` | string | ISO 8601 timestamp. |

### Activation

| Field | Type | Description |
| --- | --- | --- |
| `id` | integer | Activation id. |
| `address` | string | The activated address. |
| `status` | string | "done", "refunded" (the network refused; nothing charged), or "unknown" (not confirmed; charged while support checks it). |
| `priceSun` | integer | What it cost, in sun. |
| `priceTrx` | string | The same as an exact decimal TRX string. |
| `createdAt` | string | ISO 8601 timestamp. |

### AddressCheck

| Field | Type | Description |
| --- | --- | --- |
| `address` | string | The address checked. |
| `isActivated` | boolean | Whether it exists on-chain. Resources cannot be delegated to an address that does not. |
| `activationSun` | integer | What activating it costs now, in sun. |

Example order:

```json
{
  "data": {
    "id": 123,
    "status": "submitted",
    "resource": "energy",
    "address": "TXYZ...your-address...",
    "volume": 65000,
    "term": "1h",
    "priceSun": 2730000,
    "priceTrx": "2.73",
    "txId": "5c1e...",
    "createdAt": "2026-09-29T10:00:00.000Z",
    "updatedAt": "2026-09-29T10:00:01.000Z"
  }
}
```

## 7. Order statuses

| Status | Final | Meaning |
| --- | --- | --- |
| `pending` | no | Being placed with the network. Lasts seconds. |
| `submitted` | no | Accepted and being delegated. The price has been charged. |
| `filled` | yes | Delivered: the Energy is on the address. txId is the delegation. |
| `refunded` | yes | Could not be delivered; the full price is back on the balance. |
| `failed` | yes | Not delivered. If the balance was charged, support returns it. |
| `unknown` | no | Delivery was not confirmed. It stays charged while support checks it, then becomes filled or refunded. |

## 8. Prices and final price

- Prices follow the network's own price and are refreshed every few minutes. `GET /prices` shows the general prices; `GET /account` shows what your account pays (some accounts have their own rates).
- An order is charged at the current price when it is placed. Once it is delivered, it is settled at the network's **final** price for that delivery: if that is lower, the difference goes back to the balance; if it is higher, the difference is charged. The order's `priceSun` then shows the final price. Accounts with their own rates are charged exactly their rate, with no settlement.
- Bandwidth prices are an estimate until the order is settled.

## 9. Automations

The network runs the automation; each delivery is charged to the balance as it happens, at the network's price for that delivery (or your own rate). Every delivery is listed in `GET /deliveries` and charged exactly once.

- **refill** — adds `volume` Energy (for `term`) whenever the address holds less than `minimal`. Best for hot wallets. If the address keeps less than `minimal`, it refills again each time a delivery expires.
- **renewal** — keeps `volume` Energy on the address, renewed every day.
- **smart** — delivers 131,000 Energy and refills it after every transfer. For addresses that send one transfer at a time, no more than one every 6 seconds.

To start, the balance must cover one delivery (`nextDeliverySun`). Whenever it no longer does, the automation is paused (`pauseReason: "system"`) and — unless `autoResume` is false — resumes by itself after a deposit brings the balance back. A delivery already made is always charged, even if that takes the balance below zero; the next deposit repays it.

## 10. Idempotency and retries

- Send a new `Idempotency-Key` for every purchase and **the same key when retrying it**. If a request times out, you cannot know whether the order was placed; retrying with the same key returns the order if it was, and places it if it was not. It never charges twice.
- Reusing a key with a different address, volume or term returns `409 idempotency_conflict`.
- `402`, `422` and `503` errors from `POST /orders` charge nothing. After `422` or `503` the same key can be retried; a key that got `402` keeps returning `402`, so top up and send the purchase with a new key.
- After `429`, wait for the number of seconds in the `Retry-After` header.

## 11. Errors

Errors use HTTP status codes and a stable `code`:

```json
{
  "error": {
    "code": "insufficient_funds",
    "message": "The balance does not cover this order.",
    "details": {"priceSun": 2730000, "balanceSun": 1000000}
  }
}
```

| Status | Code | Meaning |
| --- | --- | --- |
| 400 | `invalid_json` | The request body is not valid JSON. |
| 400 | `invalid_query` | A query parameter has an invalid value. |
| 400 | `invalid_idempotency_key` | POST /orders needs an Idempotency-Key header: 8–64 letters, digits, "-" or "_". |
| 401 | `unauthorized` | Missing, invalid or revoked API key, or the account is disabled. |
| 402 | `insufficient_funds` | The balance does not cover it (for an automation: one delivery). error.details has priceSun and balanceSun. Nothing was charged. |
| 404 | `not_found` | No such order or automation on this account. |
| 409 | `idempotency_conflict` | This Idempotency-Key was already used for an order with different parameters. |
| 409 | `automation_exists` | The address already has a live automation of this kind. |
| 415 | `unsupported_media_type` | Send "Content-Type: application/json". |
| 422 | `validation_failed` | See error.details: one message per invalid field. Unknown fields are rejected. |
| 422 | `volume_out_of_range` | The network accepts a narrower range right now. error.details has min and max. Nothing was charged. |
| 429 | `rate_limited` | More than 120 requests per minute for this key, or more than 30 new orders per minute for this account. Wait for the Retry-After header (seconds). |
| 503 | `provider_unavailable` | Temporarily unavailable. Nothing was charged; retry later (for an order, with the same Idempotency-Key). |

## 12. JavaScript example

```js
const API = 'https://getgas.io/api/v1';
const headers = {Authorization: `Bearer ${process.env.GETGAS_API_KEY}`};

async function buyEnergy(address, volume, term = '1h') {
  // One key per purchase: a retry after a timeout returns the same order instead of buying twice.
  const idempotencyKey = crypto.randomUUID();
  let order;
  for (let attempt = 0; attempt < 3 && !order; attempt++) {
    const res = await fetch(`${API}/orders`, {
      method: 'POST',
      headers: {...headers, 'Content-Type': 'application/json', 'Idempotency-Key': idempotencyKey},
      body: JSON.stringify({address, volume, term}),
    }).catch(() => null);
    if (!res) continue; // network error: retry with the same key
    const body = await res.json();
    if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
    order = body.data;
  }
  if (!order) throw new Error('Could not reach the API');

  // Wait until the order is final.
  while (['pending', 'submitted', 'unknown'].includes(order.status)) {
    await new Promise(resolve => setTimeout(resolve, 3000));
    order = (await (await fetch(`${API}/orders/${order.id}`, {headers})).json()).data;
  }
  return order; // "filled", "refunded" or "failed"
}
```

## 13. Changelog

### 2026-09-29

- Orders can now be rented for one day: term "1d".
- First version: account balance, deposit address and own rates; deposits; live prices; buying Energy or Bandwidth from the balance with order status and history; address activation; automations (auto-refill, auto-renewal, smart mode) and their deliveries.