Balance History

GET

api

account

history

Balance History

curl --request GET \
  --url https://api.example.com/api/v1/account/history

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/account/history",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/account/history"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/account/history")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "id": 123,
      "delta_trx": "<string>",
      "balance_after": "<string>",
      "reason": "<string>",
      "ref_type": {},
      "ref_id": {},
      "ref_address": {},
      "created_at": "<string>"
    }
  ],
  "total": 123,
  "page": 123,
  "page_size": 123
}

Returns every movement of your account balance, newest first — purchases, deposits, refunds and fees in one list. Orders, invoices and activations each show only their own slice, so this is the only endpoint where the arithmetic closes: the sum of delta_trx over a period equals the balance change over that period.

Scope note. The view scope returns purchases, refunds and fees. Deposit movements additionally require the deposit_view scope and withdrawals require withdraw; without them those rows are simply absent from the list and from total, and filtering by such a reason returns an empty page rather than an error.

Query parameters

number

default:"1"

Page number, starting at 1.

number

default:"50"

Items per page (max 100).

string

Return only movements with this exact reason, e.g. energy_order.

Response

array

Show item

number

Movement ID. Also the sort key — the list is ordered by it, descending.

string

Amount in TRX, signed: negative is a charge, positive is money in.

string

Your balance immediately after this movement.

string

What the movement was for (see below). New reasons may appear over time — treat an unknown value as opaque rather than failing.

string | null

Entity the movement paid for: order, invoice, activation, deposit and so on. null for movements that reference nothing.

string | null

ID of that entity, as a string.

string | null

Recipient address of that entity, when it has one — so you do not need a second request to learn what a charge was for. null otherwise.

string

When the movement happened (UTC).

number

Total number of movements matching the filter.

number

Page number, starting at 1.

number

Items per page (max 100).

Common reasons

Reason	Meaning
`energy_order`	Energy purchase
`bw_order`	Bandwidth purchase
`energy_order_refund`	Refund for an energy order
`bw_order_refund`	Refund for a bandwidth order
`activation`	Creating the recipient account on-chain
`activation_refund`	Refund of an activation that did not happen
`deposit`	Incoming deposit

Example

curl "https://api.tronrental.com/v1/account/history?page=1&page_size=50" \
  -H "X-API-Key: your_api_key"

Response

{
  "items": [
    {
      "id": 97213,
      "delta_trx": "-1.79",
      "balance_after": "154.71",
      "reason": "energy_order",
      "ref_type": "order",
      "ref_id": "12345",
      "ref_address": "TYourRecipientAddress...",
      "created_at": "2026-06-10T04:30:00Z"
    },
    {
      "id": 97212,
      "delta_trx": "-1.20",
      "balance_after": "156.50",
      "reason": "activation",
      "ref_type": "activation",
      "ref_id": "8891",
      "ref_address": "TYourRecipientAddress...",
      "created_at": "2026-06-10T04:29:53Z"
    }
  ],
  "total": 2,
  "page": 1,
  "page_size": 50
}

Balance History

curl --request GET \
  --url https://api.example.com/api/v1/account/history

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/account/history",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/account/history"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/account/history")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "id": 123,
      "delta_trx": "<string>",
      "balance_after": "<string>",
      "reason": "<string>",
      "ref_type": {},
      "ref_id": {},
      "ref_address": {},
      "created_at": "<string>"
    }
  ],
  "total": 123,
  "page": 123,
  "page_size": 123
}

Core API

Bandwidth Rentals

Orders

Invoices

Smart Mode

Transfer Packages

Account

Webhooks

Balance History

Balance History

Query parameters

Response

Common reasons

Example

​Balance History

​Query parameters

​Response

​Common reasons

​Example

Balance History

Query parameters

Response

Common reasons

Example