Get Internal Account Order History

To using this feature you must have API key. Read at here to know how to get our API key

1. Get order history by API key

Get order history by API key

GET https://api.tronsave.io/v0/orders

Get many orders sort by created time. Default: return 10 newest orders

Query Parameters

Name	Type	Description
page	Integer	start from 0. Default:0
pageSize	Integer	default: 10

200: OK

{
   data:{
     id: string, // id of order
     requester: string, // the address represent for order owner
     target: string, // the address that is received resource 
     resource_amount: number, // the amount of resource
     resource_type: string, // the amount type is "ENERGY"
     remain_amount: number, // the remain amount can matching by system
     price: number, // price unit is equal to sun
     duration: number, // rent duration, duration unit is equal to second
     allow_partial_fill: boolean, //Allow the order to be filled partially or not
     payout_amount: number, // Total payout of this order
     fulfilled_percent: number, //The percent that show filling processing. 0-100
     matched_delegates:{ //All matched delegate for this order
       delegator:string // The address that delegate resource for target address
       amount: number //The amount of resource was delegated
       txid: number // The transaction id in onchain 
     }[]
   } [],
   total:number
}

Example

Header

{
  "apikey": <YOUR_API_KEY>
}

Success Response

{
    "data": [
        {
            "id": "651d0e5d8248d002ea08a231",
            "requester": "TKVSaJQDWeKFSEXmA44pjxduGTxy999999",
            "target": "TKVSaJQDWeKFSEXmA44pjxduGTxy999999",
            "resource_amount": 100000,
            "resource_type": "ENERGY",
            "remain_amount": 100000,
            "price": 45,
            "duration": 259200,
            "allow_partial_fill": false,
            "payout_amount": 4500000,
            "fulfilled_percent": 100,
            "matched_delegates": [
                {
                    "delegator": "TKVSaJQDWeKFSEXmA44pjxduGTxy888888",
                    "amount": 100000,
                    "txid": "transaction_id_1"
                }
            ]
        },
        {
            "id": "651d2306e55c073f6ca0992e",
            "requester": "TKVSaJQDWeKFSEXmA44pjxduGTxy999999",
            "target": "TKVSaJQDWeKFSEXmA44pjxduGTxy999999",
            "resource_amount": 100000,
            "resource_type": "ENERGY",
            "remain_amount": 0,
            "price": 67.5,
            "duration": 3600,
            "allow_partial_fill": true,
            "payout_amount": 6750000,
            "fulfilled_percent": 100,
             "matched_delegates": [
                {
                    "delegator": "TKVSaJQDWeKFSEXmA44pjxduGTxy888888",
                    "amount": 100000,
                    "txid": "transaction_id_2"
                }
            ]
        }
    ],
    "total": 2
}

Example Code

Javascript

const GetOrderHistory = async (api_key) => {
    const url = "https://api.tronsave.io/v0/orders"
    const data = await fetch(url, {
        headers: {
            'apikey': api_key
        }
    })
    const response = await data.json()
    /**
     * Example response
     * @link https://docs.tronsave.io/buy-energy-on-telegram/using-api-key-to/get-internal-account-order-history 
        {
            "data": [
                {
                    "id": "651d0e5d8248d002ea08a231",
                    "requester": "TKVSaJQDWeKFSEXmA44pjxduGTxy999999",
                    "target": "TKVSaJQDWeKFSEXmA44pjxduGTxy999999",
                    "resource_amount": 100000,
                    "resource_type": "ENERGY",
                    "remain_amount": 100000,
                    "price": 45,
                    "duration": 259200,
                    "allow_partial_fill": false,
                    "payout_amount": 4500000,
                    "fulfilled_percent": 100,
                    "matched_delegates": [
                        {
                            "delegator": "TKVSaJQDWeKFSEXmA44pjxduGTxy888888",
                            "amount": 100000,
                            "txid": "transaction_id_1"
                        }
                    ]
                },
                {
                    "id": "651d2306e55c073f6ca0992e",
                    "requester": "TKVSaJQDWeKFSEXmA44pjxduGTxy999999",
                    "target": "TKVSaJQDWeKFSEXmA44pjxduGTxy999999",
                    "resource_amount": 100000,
                    "resource_type": "ENERGY",
                    "remain_amount": 0,
                    "price": 67.5,
                    "duration": 3600,
                    "allow_partial_fill": true,
                    "payout_amount": 6750000,
                    "fulfilled_percent": 100,
                    "matched_delegates": [
                        {
                            "delegator": "TKVSaJQDWeKFSEXmA44pjxduGTxy888888",
                            "amount": 100000,
                            "txid": "transaction_id_2"
                        }
                    ]
                }
            ],
            "total": 2
        }
     */
    return response
}

cURL

curl --location 'https://api.tronsave.io/v0/orders' \
--header 'apikey: {{apikey}}'

2. Get one order details by api key

Get one order details by api key

GET https://api.tronsave.io/v0/orders/:id

200: OK

{
    id: string, // id of order
    requester: string, // the address represent for order owner
    target: string, // the address that is received resource 
    resource_amount: number, // the amount of resource
    resource_type: string, // the amount type is "ENERGY"
    remain_amount: number, // the remain amount can matching by system
    price: number, // price unit is equal to sun
    duration: number, // rent duration, duration unit is equal to second
    allow_partial_fill: boolean, //Allow the order to be filled partially or not
    payout_amount: number, // Total payout of this order
    fulfilled_percent: number, //The percent that show filling processing. 0-100
    matched_delegates:{ //All matched delegate for this order
       delegator:string // The address that delegate resource for target address
       amount: number //The amount of resource was delegated
       txid: number // The transaction id in onchain 
     }[]
}

Example

Header

{
  "apikey": <YOUR_API_KEY>
}

Success Response

{
      "id": "651d2306e55c073f6ca0992e",
      "requester": "TKVSaJQDWeKFSEXmA44pjxduGTxy999999",
      "target": "TKVSaJQDWeKFSEXmA44pjxduGTxy999999",
      "resource_amount": 100000,
      "resource_type": "ENERGY",
      "remain_amount": 0,
      "price": 67.5,
      "duration": 3600,
      "allow_partial_fill": true,
      "payout_amount": 6750000,
      "fulfilled_percent": 100,
       "matched_delegates": [
                {
                    "delegator": "TKVSaJQDWeKFSEXmA44pjxduGTxy888888",
                    "amount": 100000,
                    "txid": "transaction_id_1"
                }
            ]
}

Example Code

Javascript

const GetOneOrderDetails = async (api_key, order_id) => {
    const url = `https://api.tronsave.io/v0/orders/${order_id}`
    const data = await fetch(url, {
        headers: {
            'apikey': api_key
        }
    })
    const response = await data.json()
    /**
     * Example response 
     * @link https://docs.tronsave.io/buy-energy-on-telegram/using-api-key-to/get-internal-account-order-history
        {
            "id": "651d2306e55c073f6ca0992e",
            "requester": "TKVSaJQDWeKFSEXmA44pjxduGTxy999999",
            "target": "TKVSaJQDWeKFSEXmA44pjxduGTxy999999",
            "resource_amount": 100000,
            "resource_type": "ENERGY",
            "remain_amount": 0,
            "price": 67.5,
            "duration": 3600,
            "allow_partial_fill": true,
            "payout_amount": 6750000,
            "fulfilled_percent": 100,
            "matched_delegates": [
                        {
                            "delegator": "TKVSaJQDWeKFSEXmA44pjxduGTxy888888",
                            "amount": 100000,
                            "txid": "transaction_id_1"
                        }
                    ]
        }
     */
    return response
}

cURL

curl --location 'https://api.tronsave.io/v0/orders?id={{order_id}}' \
--header 'apikey: {{apikey}}'