获取内部账户订单历史
要使用此功能,您必须拥有 API 密钥。请阅读这里以了解如何获取我们的 API 密钥。
通过 API 密钥获取历史
GET
https://api.tronsave.io/v2/orders
速率限制 (Rate limit): 每1秒15个请求。
获取许多订单按创建时间排序。默认:返回10个最新订单
Query Parameters
Name
Type
Description
page
Integer
从0开始. Default: 0
pageSize
Integer
Default: 10
{
"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
}[]
]
}[],
"total": number
}
例子 (Example)
{
"apikey": <YOUR_API_KEY>
}
Example Code
const GetOrderHistory = async (apiKey) => {
const url = `${TRONSAVE_API_URL}/v2/orders`
const data = await fetch(url, {
headers: {
'apikey': apiKey
}
})
const response = await data.json()
/**
* Example response
{
"error": false,
"message": "Success",
"data":
{
"total": 2,
"data": [
{
"id": "6809b08a14b1cb7c5d195d66",
"requester": "TTgMEAhuzPchDAL4pnm2tCNmqXp13AxzAd",
"receiver": "TFwUFWr3QV376677Z8VWXxGUAMFSrq1MbM",
"resourceAmount": 40000,
"resourceType": "ENERGY",
"remainAmount": 0,
"orderType": "NORMAL",
"price": 81.5,
"durationSec": 900,
"allowPartialFill": false,
"payoutAmount": 3260000,
"fulfilledPercent": 100,
"delegates": [
{
"delegator": "THnnMCe67VMDXoivepiA7ZQSB8jbgKDodf",
"amount": 40000,
"txid": "19be98d0183b29575d74999a93154b09b3c7d05051cdbd52c667cd9f0b3cc9b0"
}
]
},
{
"id": "6809aaf2e2e17d3c588b467a",
"requester": "TTgMEAhuzPchDAL4pnm2tCNmqXp13AxzAd",
"receiver": "TFwUFWr3QV376677Z8VWXxGUAMFSrq1MbM",
"resourceAmount": 40000,
"resourceType": "ENERGY",
"remainAmount": 0,
"orderType": "NORMAL",
"price": 81.5,
"durationSec": 900,
"allowPartialFill": false,
"payoutAmount": 3260000,
"fulfilledPercent": 100,
"delegates": [
{
"delegator": "THnnMCe67VMDXoivepiA7ZQSB8jbgKDodf",
"amount": 40000,
"txid": "447e3fb28ad7580554642d08b9a6b220bc86f667b47edad47f16802594b6b1e3"
}
]
},
]
}
}
*/
return response
}
Last updated