For the complete documentation index, see llms.txt. This page is also available as Markdown.

获取订单详情

使用订单的 orderId 获取特定订单的详细信息和当前状态。

使用订单的 orderId 获取特定订单的详细信息和当前状态。响应包含订单参数、履约进度,以及与该订单匹配的每一笔链上代理(委托)。

端点

GET https://api.tronsave.io/v2/order/:id

:id 路径段是创建订单时返回的 orderId

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

请求头

名称
类型
描述

apikey*

String

代表内部账户的 TronSave API 密钥。请参阅 身份验证 以获取你的 API 密钥。

* 必填。

路径参数

名称
类型
描述

id*

String

要获取的订单的 orderId

请求体

此端点不接受请求体——在路径中传入 apikey 请求头和订单 id 即可。

响应

成功的响应返回 error: false,并在 data 中返回订单详情。

字段
类型
描述

data.id

String

订单的 ID。

data.requester

String

代表订单所有者的地址。

data.receiver

String

接收资源的地址。

data.resourceAmount

Number

资源数量。

data.resourceType

String

资源类型,为 ENERGYBANDWIDTH

data.remainAmount

Number

系统仍可匹配的剩余数量。

data.price

Number

价格,单位为 SUN。

data.durationSec

Number

租赁时长,单位为秒。

data.orderType

String

订单类型,为 NORMALEXTEND

data.allowPartialFill

Boolean

订单是否可被部分成交。

data.payoutAmount

Number

此订单的总支付金额。

data.fulfilledPercent

Number

成交进度百分比,0–100。

data.delegates

Array

此订单所有已匹配的代理(委托)。

data.delegates[].delegator

String

将资源代理(委托)给目标地址的地址。

data.delegates[].amount

Number

已代理(委托)的资源数量。

data.delegates[].txid

String

链上交易 ID。

200: OK

成功响应示例

错误

此端点使用 apikey 请求头进行身份验证。缺失或无效的密钥会返回 401

401 Unauthorized — 缺失 API 密钥

401 Unauthorized — 无效的 API 密钥

404 Not Found — 路由/路径错误

请求示例

后续步骤

Last updated