List Orders

This endpoint retrieves a list of energy orders. You can apply filters to narrow down the results.

Endpoint

POST /orders/list

Headers

Ensure the following headers are included in your request:

• Content-Type: application/json
• Accept: application/json
• Authorization: Bearer {TOKEN}
• X-Txc-Signature: {SIGN}

Request Body

The following filters can be applied to the request:

Field	Type	Description
status	int	Status of the orders.
wallet_to	string	TRON address associated with the order.
finished_at_from	datetime	Start of the finished date range.
finished_at_to	datetime	End of the finished date range.

Example Request Body

{
  "status": 6,
  "wallet_to": "TG5uzYC9uc...",
  "finished_at_from": "2024-09-01T00:00:00Z",
  "finished_at_to": "2024-09-30T23:59:59Z"
}

Example Request

PHP

// Replace these with your actual data
$url = "https://dev-site.evelar.energy/api/v1/orders/list";
$token = "YOUR_TOKEN";
$secret = "MYSECRET";
$body = json_encode([
    "status" => 6,
    "wallet_to" => "TG5uzYC9uc...",
    "finished_at_from" => "2024-09-01T00:00:00Z",
    "finished_at_to" => "2024-09-30T23:59:59Z"
]);

// Generate the signature
$sign = hash('sha256', $body . $secret);

// Headers
$headers = [
    "Content-Type: application/json",
    "Accept: application/json",
    "Authorization: Bearer $token",
    "X-Txc-Signature: $sign"
];

// Initialize cURL
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

// Execute request and get the response
$response = curl_exec($ch);
curl_close($ch);

// Output response
echo $response;

Python

import requests
import hashlib
import json

url = "https://dev-site.evelar.energy/api/v1/orders/list"
token = "YOUR_TOKEN"
secret = "MYSECRET"
body = json.dumps({
    "status": 6,
    "wallet_to": "TG5uzYC9uc...",
    "finished_at_from": "2024-09-01T00:00:00Z",
    "finished_at_to": "2024-09-30T23:59:59Z"
})

# Generate the signature
sign = hashlib.sha256((body + secret).encode('utf-8')).hexdigest()

# Headers
headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "Authorization": f"Bearer {token}",
    "X-Txc-Signature": sign
}

# Make the request
response = requests.post(url, headers=headers, data=body)
print(response.json())

Node.js

const axios = require('axios');
const crypto = require('crypto');

const url = "https://dev-site.evelar.energy/api/v1/orders/list";
const token = "YOUR_TOKEN";
const secret = "MYSECRET";
const body = JSON.stringify({
    status: 6,
    wallet_to: "TG5uzYC9uc...",
    finished_at_from: "2024-09-01T00:00:00Z",
    finished_at_to: "2024-09-30T23:59:59Z"
});

// Generate the signature
const sign = crypto.createHash('sha256').update(body + secret).digest('hex');

// Headers
const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "Authorization": `Bearer ${token}`,
    "X-Txc-Signature": sign
};

// Make the request
axios.post(url, body, { headers })
    .then(response => console.log(response.data))
    .catch(error => console.error(error));

Bash

url="https://dev-site.evelar.energy/api/v1/orders/list"
token="YOUR_TOKEN"
secret="MYSECRET"
body='{"status":6,"wallet_to":"TG5uzYC9uc...","finished_at_from":"2024-09-01T00:00:00Z","finished_at_to":"2024-09-30T23:59:59Z"}'

# Generate the signature
sign=$(echo -n "$body$secret" | openssl dgst -sha256 -hex | awk '{print $2}')

# Make the request
curl -X POST $url \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $token" \
  -H "X-Txc-Signature: $sign" \
  -d "$body"

Example Response

{
   "code": 0,
   "result": {
       "count": 4,
       "next": "",
       "previous": "",
       "results": [
           {
               "id": "4694d23c-39da-4c5e-ad3b-9540e6e1d397",
               "created_at": "2024-09-23T08:12:00Z",
               "status": 6,
               "wallet_to": "TG5uzYC9uc...",
               "amount": 7000,
               "delegated": 0,
               "reclaimed": 0,
               "duration": 1,
               "finished_at": "2024-09-24T08:12:00Z",
               "user_id": 3
           }
       ]
   }
}

Response Fields

Field	Type	Description
count	int	Total number of matching orders.
next	string	URL for the next page of results.
previous	string	URL for the previous page of results.
results	array	List of orders.
id	string	Unique ID of the order.
created_at	datetime	Date and time the order was created.
status	int	Current status of the order.
wallet_to	string	TRON address associated with the order.
amount	int	Amount of energy in the order.
delegated	int	Amount of energy delegated.
reclaimed	int	Amount of energy reclaimed.
duration	int	Duration of the order in days.
finished_at	datetime	Date and time the order was finished.
user_id	int	ID of the user associated with the order.