Get one order details
Last updated
Last updated
To use this feature, you must have the API key. Read to view how to get our API key
GET
https://api.tronsave.io/v2/orders/:id
Rate limit: 15 requests per 1 second
{
"error": false,
"message": "Success",
"data": {
"id": string, // id of order
"requester": string, // the address represents the order owner
"receiver": string, // the address of the resource that is received
"resourceAmount": number, // the amount of resource
"resourceType": string, // the resource type is "ENERGY" or "BANDWIDTH"
"remainAmount": number, // the remaining amount can be matched by the system,
"price": number, // price unit is equal to SUN
"durationSec": number, // rent duration, duration unit is equal to seconds
"orderType": string, // type of order is "NORMAL" or "EXTEND"
"allowPartialFill": boolean, //Allow the order to be filled partially or not
"payoutAmount": number, // Total payout of this order
"fulfilledPercent": number, //The percent that shows filling processing. 0-100
"delegates": [ //All matched delegates for this order
{
"delegator": string, // The address that delegates the resource for the target address
"amount": number, //The amount of resource was delegated
"txid": number // The transaction ID in onchain
}
]
}
}
Example
{
"apikey": <YOUR_API_KEY>
}
{
"error": false,
"message": "Success",
"data": {
"id": "6819c7578729a45600f740d1",
"requester": "TFwUFWr3QV376677Z8VWXxGUAMFSSSSSS",
"receiver": "TFwUFWr3QV376677Z8VWXxGUAMFSSSSSSS",
"resourceAmount": 32000,
"resourceType": "ENERGY",
"remainAmount": 0,
"price": 90,
"durationSec": 300,
"orderType": "NORMAL",
"allowPartialFill": false,
"payoutAmount": 2880000,
"fulfilledPercent": 100,
"delegates": [
{
"delegator": "THnnMCe67VMDXoivepiA7ZQSB888888",
"amount": 32000,
"txid": "19d3fa76a722d6d6e671e6141eb8057760d38d42b353153a3825f19a7d34326f"
}
]
}
}
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
}
function getOrderDetails(string $orderId): array {
$url = TRONSAVE_API_URL . "/v2/order/" . $orderId;
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'apikey: ' . API_KEY
]);
$response = curl_exec($ch);
curl_close($ch);
return json_decode($response, true);
}
def get_order_details(order_id: str) -> Dict[str, Any]:
"""Get order details"""
url = f"{TRONSAVE_API_URL}/v2/order/{order_id}"
headers = {'apikey': API_KEY}
response = requests.get(url, headers=headers)
return response.json()