Historico de Saldo

GET

api

account

history

Historico 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
}

Retorna todos os movimentos do saldo da sua conta, do mais recente para o mais antigo: compras, depositos, reembolsos e taxas em uma unica lista. Pedidos, faturas e ativacoes mostram cada um apenas a sua parte, portanto este e o unico endpoint em que a aritmetica fecha: a soma de delta_trx em um periodo e igual a variacao do saldo nesse periodo.

Sobre os escopos. O escopo view retorna compras, reembolsos e taxas. Movimentos de deposito exigem tambem o escopo deposit_view e saques exigem withdraw; sem eles essas linhas simplesmente nao aparecem na lista nem em total, e filtrar por esse motivo devolve uma pagina vazia, nao um erro.

Parametros de consulta

number

padrão:"1"

Numero da pagina, a partir de 1.

number

padrão:"50"

Itens por pagina (maximo 100).

string

Retorna apenas movimentos com este motivo exato, por exemplo energy_order.

Resposta

array

Mostrar item

number

ID do movimento. Tambem e a chave de ordenacao: a lista vem em ordem decrescente.

string

Valor em TRX com sinal: negativo e cobranca, positivo e entrada.

string

Seu saldo imediatamente apos este movimento.

string

Para que foi o movimento (veja abaixo). Novos motivos podem surgir com o tempo: trate um valor desconhecido como opaco em vez de falhar.

string | null

Entidade paga: order, invoice, activation, deposit etc. null quando nao referencia nada.

string | null

ID dessa entidade, como string.

string | null

Endereco de destino dessa entidade, quando existe, para dispensar uma segunda requisicao. Caso contrario, null.

string

Quando o movimento ocorreu (UTC).

number

Total de movimentos que atendem ao filtro.

number

Numero da pagina, a partir de 1.

number

Itens por pagina (maximo 100).

Motivos comuns

Motivo	Significado
`energy_order`	Compra de energia
`bw_order`	Compra de bandwidth
`energy_order_refund`	Reembolso de um pedido de energia
`bw_order_refund`	Reembolso de um pedido de bandwidth
`activation`	Criacao da conta destinataria na rede
`activation_refund`	Reembolso de uma ativacao que nao ocorreu
`deposit`	Deposito recebido

Exemplo

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
}

Historico 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

Aluguéis de largura de banda

Pedidos

Faturas

Smart Mode

Pacotes de transferência

Conta

Webhooks

Historico de Saldo