---
title: 通过API购买波场能量：TronSave API v2开发者指南
description: 用TronSave REST API v2购买波场能量：获取API key，用curl或fetch估价下单并处理错误。价格截至2026年11月。
url: https://blog.tronsave.io/zh/api-goumai-bochang-nengliang-tronsave/
canonical: https://blog.tronsave.io/zh/api-goumai-bochang-nengliang-tronsave/
lang: zh-CN
datePublished: 2026-11-13T00:39:14+00:00
dateModified: 2026-11-13T00:39:14+00:00
author: TronSave
publisher: TronSave (https://tronsave.io/)
categories:
  - 波场指南
keywords: API购买波场能量,波场能量API,TronSave API,TronSave API key,波场能量租赁API,buy-resource API v2
translations:
  en: https://blog.tronsave.io/automate-buy-tron-energy-with-api-guide/
  ru: https://blog.tronsave.io/ru/kupit-energiyu-tron-cherez-api/
  es: https://blog.tronsave.io/es/automatizar-compra-energia-tron-api/
  pt: https://blog.tronsave.io/pt/comprar-energia-tron-com-api/
  de: https://blog.tronsave.io/de/tron-energie-per-api-kaufen/
---

# 通过API购买波场能量：TronSave API v2开发者指南

![通过API购买波场能量以降低TRC-20手续费的开发者指南](https://blog.tronsave.io/wp-content/uploads/2025/05/Article-5-1024x597.jpg "如何通过API购买波场能量")

来源：TronSave博客

**简要回答（截至2026年11月）：**要通过API购买波场（TRON）能量，先获取TronSave API key（在[tronsave.io/market](https://tronsave.io/zh-CN/market)连接钱包 → Account Info → Login TronSave），向内部账户充值至少10 TRX，然后发送两个HTTP请求：`POST https://api.tronsave.io/v2/estimate-buy-resource`用于估价，`POST https://api.tronsave.io/v2/buy-resource`（带请求头`apikey: YOUR_API_KEY`）用于下单。用`GET /v2/order/{orderId}`查询结果。2026年11月，一笔USDT转账所需的能量（约65,000单位，租期15分钟）约4.2 TRX，而直接燃烧约需6.43 TRX。

本指南介绍原生REST API：任何编程语言、cron定时任务或无代码工具都能直接发起的HTTP请求。如果你更想安装软件包，[TronSave SDK指南](https://blog.tronsave.io/buy-tron-energy-with-code-tronsave-sdk/)为Node.js、Python、Rust、Java和PHP封装了相同的接口。

## 要点总结

-   当前TronSave API版本为**v2**（基础URL `https://api.tronsave.io`；Nile测试网`https://api-dev.tronsave.io`）。`/v0/estimate-trx`等旧版v0接口仅为向后兼容而保留。
-   两种支付方式：**API key**配合预充值的内部账户（每笔订单无需链上签名，最适合机器人），或**签名交易**，每笔订单从你自己的钱包付款（非托管）。
-   向持有USDT的地址转一笔USDT（TRC-20）约需64,285能量，向从未持有USDT的地址约需130,285能量。没有能量时，网络会燃烧约6.43 TRX或13.03 TRX（每单位能量100 sun，截至2026年11月）。
-   大多数接口限速为每秒15次请求。错误以`{"error": true, "message": "TSAS:107 INVALID_API_KEY"}`这类错误码返回，可在代码中直接处理。
-   租赁能量代替燃烧TRX，最高可节省80%，具体取决于数量和租期。

## 波场能量API能做什么？

波场能量API让你的代码无需打开网站即可租赁能量。能量是波场网络中用于支付智能合约调用（如USDT转账）的资源。后端发送包含接收地址、数量和租期的请求，TronSave将其与能量卖家撮合，能量随即代理到该地址，通常只需几秒。

为什么值得这样做：没有能量的地址每笔USDT转账都要燃烧TRX。截至2026年11月，网络按每单位能量100 sun收费，一笔转账约燃烧6.43 TRX（转给从未持有USDT的地址约13.03 TRX）。燃烧的TRX数量与TRX价格无关，只有其美元价值随币价变化。每天发送数百笔转账的交易所、支付网关、钱包或工资发放脚本，先租能量能大幅降低成本。背景知识：[波场能量与带宽详解](https://blog.tronsave.io/zh/bochang-nengliang-daikuan-zhinan-2026/)。

### 代码应该租赁、质押还是燃烧？

| 方式 | 单笔USDT转账成本（2026年11月） | 适用场景 |
| --- | --- | --- |
| 燃烧TRX（无能量） | ≈ 6.43 TRX（新USDT地址≈ 13.03 TRX） | 偶尔、一次性转账 |
| 通过API租赁，15分钟 | ≈ 4.2 TRX，65,000能量，单价≈ 65 sun | 突发或难以预测的发送量 |
| 通过API租赁，30天 | 每笔≈ 2.4 TRX（1,000,000能量，每天≈ 37 sun） | 每日稳定的发送量 |
| 质押自有TRX | 无单笔成本，但每日每笔转账需锁定≈ 6,650 TRX | 大额TRX持有者 |

价格取自2026年11月12日的TronSave市场，会随供需变化；最新价格请参阅每月的[波场能量价格报告](https://blog.tronsave.io/zh/bochang-nengliang-jiage-baogao/)。质押计算：[波场Stake 2.0指南](https://blog.tronsave.io/zh/bochang-zhiya-stake-2-0-apy-nengliang-daikuan/)。

## 如何通过API购买波场能量？分步说明

以下步骤采用官方[TronSave开发者快速入门](https://docs.tronsave.io/developers/quickstart)中的API key方式。把基础URL换成`https://api-dev.tronsave.io`，所有示例都能在Nile测试网运行（各网络的key和余额相互独立；不支持Shasta）。

### 第1步：获取API key并为内部账户充值

1.  打开[tronsave.io/market](https://tronsave.io/zh-CN/market)，点击**Connect**连接钱包（TronLink或其他波场钱包）。
2.  点击你的地址 → **Account Info** → **Login TronSave**，并签名消息。
3.  复制页面显示的**API key**和**充值地址**。也可以在[TronSave Telegram机器人](https://blog.tronsave.io/zh/telegram-goumai-bochang-nengliang-daikuan/)的User Info → API key中获取。
4.  点击**Top up**，向充值地址转入TRX。最低充值10 TRX；首次充值需额外约1 TRX用于激活地址，每天2次免费充值之后，每次额外充值收取0.3 TRX（TronSave文档，2026年11月）。

确认余额已到账（约3秒更新）：

```
curl https://api.tronsave.io/v2/user-info -H "apikey: YOUR_API_KEY"

# {"error": false, "data": {"balance": "50000000", "depositAddress": "T...", ...}}
# balance is in sun: 50000000 sun = 50 TRX
```

### 第2步：妥善保管API key

-   该key可以花费你充值的TRX。只把它放在服务器端：环境变量或密钥管理服务中，切勿写进前端代码或git仓库。
-   只充值机器人几天所需的金额，内部余额就相当于支出上限。
-   如果key泄露，点击**Revoke**（网站或Telegram）生成新key。旧key会立即失效，因此要更新所有使用它的服务。

### 第3步：先估价，再创建订单

先请求报价。估价接口不需要API key：

```
curl -X POST https://api.tronsave.io/v2/estimate-buy-resource \
  -H "Content-Type: application/json" \
  -d '{
    "receiver": "TYourReceiverAddress",
    "resourceType": "ENERGY",
    "resourceAmount": 65000,
    "durationSec": 900,
    "unitPrice": "MEDIUM"
  }'

# {"error": false, "data": {"unitPrice": 64, "durationSec": 900,
#   "estimateTrx": 4230000, "availableResource": 65000}}
```

`estimateTrx`以sun为单位（4,230,000 sun = 4.23 TRX）。如果`availableResource`低于你的需求量，说明市场目前无法完全满足该订单。`unitPrice`可选`"SLOW"`（最便宜，不着急）、`"MEDIUM"`（默认）或`"FAST"`（立即成交，价格更高）。`durationSec`是以秒为单位的租期：900 = 15分钟，259200 = 3天。

然后下单，请求体相同，另加API key和订单选项：

```
curl -X POST https://api.tronsave.io/v2/buy-resource \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "receiver": "TYourReceiverAddress",
    "resourceType": "ENERGY",
    "resourceAmount": 65000,
    "durationSec": 900,
    "unitPrice": "MEDIUM",
    "options": {
      "allowPartialFill": true,
      "preventDuplicateIncompleteOrders": true,
      "maxPriceAccepted": 100
    }
  }'

# {"error": false, "message": "Success", "data": {"orderId": "6818426a65fa8ea36d119999"}}
```

各选项的作用：`allowPartialFill`在供应不足时接受部分成交；`preventDuplicateIncompleteOrders`防止在第一笔订单未完成时因重试而创建第二笔订单；`maxPriceAccepted`（sun）在价格高于你的上限时拒绝订单。如果订单必须全部成交否则不成交，使用`onlyCreateWhenFulfilled: true`。这些选项与网站订单类型的对应关系见：[TronSave订单类型详解](https://blog.tronsave.io/zh/tronsave-dingdan-leixing-xiangjie/)。

### 第4步：查询订单和已代理的能量

```
curl https://api.tronsave.io/v2/order/6818426a65fa8ea36d119999 -H "apikey: YOUR_API_KEY"

# "fulfilledPercent": 100  -> fully delegated
# "fulfilledPercent": 1-99 -> partly filled (only with allowPartialFill)
# "fulfilledPercent": 0    -> waiting for a seller
# "delegates": [{"delegator": "T...", "amount": 65000, "txid": "..."}]
```

每个`txid`都是一笔链上代理交易，可在TronScan上查看。在发送USDT之前，如需确认接收地址确实已获得能量，可从波场节点读取其资源（TronGrid `wallet/getaccountresource`；参见[如何获取TronGrid API key](https://blog.tronsave.io/zh/bochang-api-miyao-tron-api-key/)）。

## 完整流程用代码怎么写？

一个最简的Node.js 18+脚本（使用内置`fetch`，无需安装包），完成估价、带价格上限下单并等待成交：

```
const API = "https://api.tronsave.io";        // testnet: https://api-dev.tronsave.io
const KEY = process.env.TRONSAVE_API_KEY;
const RECEIVER = process.env.RECEIVER;

async function call(path, body) {
  const res = await fetch(API + path, {
    method: body ? "POST" : "GET",
    headers: { "apikey": KEY, "Content-Type": "application/json" },
    body: body ? JSON.stringify(body) : undefined,
  });
  const json = await res.json();
  if (json.error) throw new Error(json.message);  // e.g. "TSAS:107 INVALID_API_KEY"
  return json.data;
}

async function buyEnergy(amount = 65000, durationSec = 900) {
  const order = { receiver: RECEIVER, resourceType: "ENERGY",
                  resourceAmount: amount, durationSec, unitPrice: "MEDIUM" };
  const est = await call("/v2/estimate-buy-resource", order);
  console.log("Estimated cost:", est.estimateTrx / 1e6, "TRX");

  const { orderId } = await call("/v2/buy-resource", { ...order,
    options: { allowPartialFill: true, preventDuplicateIncompleteOrders: true,
               maxPriceAccepted: 100 } });

  for (let i = 0; i < 12; i++) {                 // poll up to ~1 minute
    await new Promise(r => setTimeout(r, 5000));
    const s = await call("/v2/order/" + orderId);
    if (s.fulfilledPercent === 100) return s;
  }
  throw new Error("Order " + orderId + " not filled yet");
}

buyEnergy().then(s => console.log("Delegated", s.resourceAmount, "energy"));
```

同样的三个调用也可以用Python（`requests`）、PHP（cURL）、Go或无代码HTTP步骤实现。更多完整示例见[TronSave代码示例](https://docs.tronsave.io/developers/code-examples)。

![TronSave能量市场界面，显示Buy Energy面板和实时订单簿](https://blog.tronsave.io/wp-content/uploads/2025/09/Energy-rental-interface-on-Tronsave-copy.png)

TronSave能量市场：设置目标地址、数量和价格即可租赁波场能量，右侧为实时订单簿。来源：TronSave。

## API key还是签名交易：该用哪种？

|  | API key（内部账户） | 签名交易 |
| --- | --- | --- |
| 谁付款 | 你预充值的TronSave余额 | 你自己的钱包，按单支付 |
| 每笔订单的链上手续费 | 无 | 有（TRX付款交易） |
| 集成方式 | 一个请求头，最简单 | 估价 → 签名（自己的代码或`POST /v2/signed-tx`） → 创建订单 |
| 资金托管 | TronSave保管充值的TRX | 非托管 |
| 适用场景 | 机器人、交易所、高并发后端 | 钱包应用及不能把资金放在第三方的业务流程 |

两种方式都使用相同的`/v2/estimate-buy-resource`和`/v2/buy-resource`接口；签名交易方式随订单发送已签名的TRX付款，而不是`apikey`请求头。详见：[TronSave文档中的Buy Resources](https://docs.tronsave.io/developers/api-reference/buy-resources)。

## TronSave API还能做什么？

-   **订单续期：**查找可续期的代理，在到期前延长时间，而不必重新购买（与[网站上的Extend功能](https://blog.tronsave.io/zh/tronsave-extend-xuzu-zhuijia-nengliang/)原理相同）。
-   **带宽：**将`resourceType`设为`"BANDWIDTH"`，用于TRX转账等只消耗带宽的交易。
-   **激活地址：**检查地址是否已激活，每次请求最多激活100个地址，适合向新用户付款前使用。
-   **出售能量：**把你自己质押获得的能量挂到市场出售（这些接口限速为每秒2–3次请求）。
-   **AI智能体：**[TronSave MCP服务器](https://blog.tronsave.io/tronsave-mcp-server-ai-agent-tron-energy/)将相同功能开放给Claude、Cursor及其他MCP客户端。

不是开发者？[Auto-Buy](https://blog.tronsave.io/zh/tronsave-auto-buy-zidong-goumai-nengliang/)无需写代码即可让地址的能量保持充足。

## 通过API购买能量能省多少？

示例：某服务每天向已持有USDT的地址发送200笔USDT转账（价格截至2026年11月）：

| 方式 | 每天TRX | 每30天TRX |
| --- | --- | --- |
| 燃烧TRX（每笔≈ 6.43 TRX） | ≈ 1,286 | ≈ 38,570 |
| 按笔租赁，15分钟（每笔≈ 4.2 TRX） | ≈ 840 | ≈ 25,200 |
| 租赁30天整块能量（每笔≈ 2.4 TRX） | ≈ 480 | ≈ 14,400 |

30天整块租赁之所以划算，是因为代理的能量会在24小时内恢复，一块能量每天都能覆盖固定数量的转账。租赁价格随市场波动，做预算前请用估价接口为每笔订单定价；与燃烧TRX相比，最高可节省80%，具体取决于数量和租期。估算所需数量：[发送USDT需要多少TRX](https://blog.tronsave.io/zh/zhuanzhang-usdt-xuyao-duoshao-trx/)。

## 如何保证能量自动化系统安全可靠？

-   **处理限速：**大多数接口限速为每秒15次请求，超出后返回HTTP 429 `Rate limit reached`。使用退避重试（1秒、2秒、4秒）。
-   **处理常见错误：**`API_KEY_REQUIRED` / `INVALID_API_KEY`（401，检查请求头）、`INTERNAL_BALANCE_ACCOUNT_TOO_LOW`（充值）、`CANNOT_FULFILLED`（允许部分成交或提高`unitPrice`）、`PRICE_EXCEED_MAX_PRICE_REQUIRED`（市场价高于你的`maxPriceAccepted`）。按错误码匹配，而不是按消息文本。
-   **让重试更安全：**保持`preventDuplicateIncompleteOrders: true`，避免超时后重试导致重复购买。
-   **设置价格上限：**把`maxPriceAccepted`设在100 sun燃烧价格以下（截至2026年11月）；高于此价格租赁毫无意义。
-   **先在Nile测试：**从Nile水龙头领取测试TRX，在`api-dev.tronsave.io`上跑通完整流程。

## 常见问题

### TronSave有购买波场能量的API吗？

有。TronSave REST API v2（`https://api.tronsave.io`）支持能量和带宽订单的估价、购买、查询和续期。官方的Node.js、Python、Rust、Java和PHP SDK以及MCP服务器都基于同一API。

### 如何获取TronSave API key？

在tronsave.io/market连接钱包，打开Account Info，点击Login TronSave并签名，API key和充值地址就会显示在那里。在Telegram机器人中，它位于User Info → API key。

### v0 API（/v0/estimate-trx）还能用吗？

它为向后兼容而保留，但截至2026年11月，TronSave文档将v2列为当前API。新的集成应使用`/v2/estimate-buy-resource`和`/v2/buy-resource`。

### 一笔USDT转账，代码应该买多少能量？

接收方已持有USDT时约65,000能量，从未持有USDT时约131,000能量（精确值分别为64,285和130,285，截至2026年11月）。多买一点可以覆盖合约的小幅变化。

### 能量多久到账？

订单撮合后通常几秒到几分钟内到账。发送转账前，轮询`GET /v2/order/{orderId}`直到`fulfilledPercent`为100。

### 可以为其他地址购买能量吗？

可以。将`receiver`设为任意波场地址，例如客户地址或热钱包地址。付款方和接收方可以不同。参见[为其他钱包购买能量](https://blog.tronsave.io/zh/wei-qita-qianbao-goumai-bochang-nengliang/)。

### 买了能量，USDT转账为什么还在燃烧TRX？

可能是订单只部分成交、能量代理到了其他地址、租期已到期，或者接收方从未持有USDT，转账需要约130,285能量。此外，发送方本身还需要带宽（或少量TRX）来支付交易。

**⚠️ 非投资建议。**本文仅供教育和信息参考，代表作者撰写时的观点，**不**构成投资、财务、法律或税务建议。加密货币波动性极高，你可能损失全部本金；价格、APY和链上手续费不断变化，文中数据可能已过时。在买入、卖出、质押或出借任何数字资产之前，请务必**自行研究（DYOR）**，并咨询持牌财务顾问。

**披露：**这是TronSave官方博客。TronSave销售波场能量/资源（降低手续费）服务，与本文涉及的产品和话题存在商业利益关系。

**更喜欢用SDK？**参见使用TronSave SDK（Node.js、Python、Rust、Java、PHP）[通过代码购买波场能量](https://blog.tronsave.io/buy-tron-energy-with-code-tronsave-sdk/)。
