波场指南

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

作者 TronSave 发布于 9 分钟阅读
本页目录
通过API购买波场能量以降低TRC-20手续费的开发者指南
来源:TronSave博客

简要回答(截至2026年11月):要通过API购买波场(TRON)能量,先获取TronSave API key(在tronsave.io/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指南为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价格无关,只有其美元价值随币价变化。每天发送数百笔转账的交易所、支付网关、钱包或工资发放脚本,先租能量能大幅降低成本。背景知识:波场能量与带宽详解。

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

方式单笔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市场,会随供需变化;最新价格请参阅每月的波场能量价格报告。质押计算:波场Stake 2.0指南。

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

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

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

  1. 打开tronsave.io/market,点击Connect连接钱包(TronLink或其他波场钱包)。
  2. 点击你的地址 → Account Info → Login TronSave,并签名消息。
  3. 复制页面显示的API key和充值地址。也可以在TronSave Telegram机器人的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订单类型详解。

第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)。

完整流程用代码怎么写?

一个最简的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代码示例。

TronSave能量市场界面,显示Buy Energy面板和实时订单簿
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。

TronSave API还能做什么?

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

不是开发者?Auto-Buy无需写代码即可让地址的能量保持充足。

通过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。

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

  • 处理限速:大多数接口限速为每秒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设为任意波场地址,例如客户地址或热钱包地址。付款方和接收方可以不同。参见为其他钱包购买能量。

买了能量,USDT转账为什么还在燃烧TRX?

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

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

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

TronSave
TronSave

TronSave 团队在 tronsave.io 运营波场能量与带宽市场,这些指南基于在波场主网上的实际测试撰写。

相关文章

我们使用 Google Analytics 了解哪些指南对读者有帮助。只有在您允许分析时才会设置 Cookie。本博客不投放广告。 隐私