Historial de saldo

GET

api

account

history

Historial de saldo

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
}

Devuelve todos los movimientos del saldo de tu cuenta, los mas recientes primero: compras, depositos, reembolsos y comisiones en una sola lista. Los pedidos, las facturas y las activaciones muestran cada uno solo su parte, por lo que este es el unico endpoint donde la aritmetica cuadra: la suma de delta_trx en un periodo equivale al cambio de saldo en ese mismo periodo.

Sobre los scopes. El scope view devuelve compras, reembolsos y comisiones. Los movimientos de deposito requieren ademas el scope deposit_view y los retiros requieren withdraw; sin ellos esas filas simplemente no aparecen en la lista ni en total, y filtrar por ese motivo devuelve una pagina vacia, no un error.

Parametros de consulta

number

predeterminado:"1"

Numero de pagina, empezando en 1.

number

predeterminado:"50"

Elementos por pagina (maximo 100).

string

Devolver solo movimientos con este motivo exacto, por ejemplo energy_order.

Respuesta

array

Mostrar item

number

ID del movimiento. Tambien es la clave de orden: la lista va de mayor a menor.

string

Importe en TRX con signo: negativo es cargo, positivo es ingreso.

string

Tu saldo inmediatamente despues de este movimiento.

string

Para que fue el movimiento (ver abajo). Con el tiempo pueden aparecer motivos nuevos: trata un valor desconocido como opaco en lugar de fallar.

string | null

Entidad que se pago: order, invoice, activation, deposit, etc. null si no referencia nada.

string | null

ID de esa entidad, como cadena.

string | null

Direccion de destino de esa entidad, cuando la tiene, para no necesitar una segunda peticion. null en caso contrario.

string

Cuando ocurrio el movimiento (UTC).

number

Numero total de movimientos que cumplen el filtro.

number

Numero de pagina, empezando en 1.

number

Elementos por pagina (maximo 100).

Motivos frecuentes

Motivo	Significado
`energy_order`	Compra de energia
`bw_order`	Compra de bandwidth
`energy_order_refund`	Reembolso de un pedido de energia
`bw_order_refund`	Reembolso de un pedido de bandwidth
`activation`	Creacion de la cuenta destinataria en la red
`activation_refund`	Reembolso de una activacion que no ocurrio
`deposit`	Deposito entrante

Ejemplo

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
}

Historial de saldo

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
}

API Principal

Alquileres de ancho de banda

Órdenes

Facturas

Smart Mode

Paquetes de transferencia

Cuenta

Webhooks

Historial de saldo