获取单个订单详情
要使用此功能,您必须拥有 API 密钥。请阅读这里以了解如何获取我们的 API 密钥。
通过 API 密钥获取一个订单的详细信息
GET
https://api.tronsave.io/v2/orders/:id
速率限制 (Rate limit): 每1秒15个请求。
{
"error": false,
"message": "Success",
"data": {
"id": string, // 订单 ID
"requester": string, // 代表订单所有者的地址
"receiver": string, // 接收资源的地址
"resourceAmount": number, // 资源数量
"resourceType": string, // 资源类型,可以是 "ENERGY" 或 "BANDWIDTH"
"remainAmount": number, // 系统可以匹配的剩余数量
"price": number, // 价格,单位为 SUN
"durationSec": number, // 租赁时长,单位为秒
"orderType": string, // 订单类型,"NORMAL" 或 "EXTEND"
"allowPartialFill": boolean, // 是否允许部分匹配
"payoutAmount": number, // 订单的总支付金额
"fulfilledPercent": number, // 显示填充进度的百分比,范围 0-100
"delegates": [ // 所有匹配的委托人
{
"delegator": string, // 为目标地址委托资源的地址
"amount": number, // 委托的资源数量
"txid": number // 链上交易 ID
}
]
}
}
例子 (Example)
{
"apikey": <YOUR_API_KEY>
}
Example code:
const GetOneOrderDetails = async (api_key, order_id) => {
const url = `${TRONSAVE_API_URL}/v2/order/${order_id}`
const data = await fetch(url, {
headers: {
'apikey': api_key
}
})
const response = await data.json()
/**
* Example response
{
"error": false,
"message": "Success",
"data": {
"id": "680b3e9939...600b7734d",
"requester": "TTgMEAhuzPch...nm2tCNmqXp13AxzAd",
"receiver": "TAk6jzZqHwNU...yAE1YAoUPk7r2T6h",
"resourceAmount": 32000,
"resourceType": "ENERGY",
"remainAmount": 0,
"price": 91,
"durationSec": 3600,
"orderType": "NORMAL",
"allowPartialFill": false,
"payoutAmount": 2912000,
"fulfilledPercent": 100,
"delegates": [
{
"delegator": "TQ5VcQjA7w...Pio485UDhCWAANrMh",
"amount": 32000,
"txid": "b200e8b7f9130b67ff....403c51d6f7a92acc7c4618906c375b69"
}
]
}
}
*/
return response
}
Last updated