出售资源

通过将活跃买单与已签名的链上代理交易进行撮合,在 TronSave 上手动出售能量或带宽。

出售资源 API 让资源供应商可以在 TronSave 上手动成交未完成的买单。卖家获取活跃订单,构建并签名一笔链上 DelegateResourceContract 交易,然后将签名交易提交给 TronSave 进行订单撮合与结算。

出售是一个两步流程:

  1. 获取活跃订单 — 列出您可以成交的未完成买单。

  2. 出售资源 — 针对选定的订单提交一笔签名代理交易。

Step 1: 获取活跃订单

返回可供撮合的全局活跃买单列表。

GET https://api.tronsave.io/v2/orders/active-global

速率限制: 每 1 秒 3 次请求。

Headers

Name
Type
Description

apikey *

String

TronSave API 密钥(必须属于白名单地址)。参见 身份验证

查询参数

Name
Type
Description

page

Integer

页索引,从 0 开始。默认值:0

pageSize

Integer

每页订单数量。默认值:10

响应

响应示例

请求示例

Step 2: 出售资源

提交一笔签名代理交易以成交选定的订单。

POST https://api.tronsave.io/v2/orders/sell-manual

速率限制: 每 1 秒 2 次请求。

Headers

Name
Type
Description

apikey *

String

TronSave API 密钥(必须属于白名单地址)。参见 身份验证

请求体

Name
Type
Description

orderId *

string

来自 Step 1id 字段的订单 ID。

paymentAddress

string

接收出售订单付款的 TRON 地址。如果未提供,付款将发送至委托方(delegator)地址。

isAllowSellForLockedDelegator

boolean

false(默认)— 不出售给当前在链上被锁定的目标地址。 true — 出售给所有目标地址。

signedTx *

object

签名交易。请注意它是一个 JSON 对象。

请求体示例

响应(成功)

响应(错误)

两个出售端点都要求提供属于白名单地址的有效 apikey 请求头。身份验证和校验失败会返回下列响应体之一。

401 Unauthorized — 缺少 API 密钥(没有 apikey 请求头):

401 Unauthorized — 无效的 API 密钥

400 Bad Request — 请求体校验失败(缺少必填字段或字段无效;message 会指出出错的字段,例如 orderIdsignedTx):

404 Not Found — 路由/路径错误

业务逻辑失败(例如所选订单已无法成交,或签名交易与订单不匹配)会返回标准的 TronSave 响应封装,其中 errortruemessage 包含描述性说明:

速率限制: 全局默认限制为每秒 15 次请求;出售资源端点限制为每秒 2–3 次请求(active-global 为每秒 3 次,sell-manual 为每秒 2 次)。超过限制会返回 {"error": true, "message": "Rate limit reached"}

请求示例

端到端示例:构建签名交易

Step 2 中的签名交易是一笔 TRON DelegateResourceContract,它将资源从您的钱包(委托方 delegator)代理给订单的 receiver(接收地址)。下面的示例使用 TronWeb 获取活跃订单、选取价格最高的订单、推导冻结费率、构建并签名代理交易,然后提交。

本示例面向 Nile(测试网)。TronSave 基础 URL https://api-dev.tronsave.io 和 TronWeb 全节点 https://api.nileex.io 用于测试。对于主网,请使用 https://api.tronsave.iohttps://api.trongrid.io

后续步骤

Last updated