बैलेंस इतिहास

GET

api

account

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
}

बैलेंस इतिहास

आपके खाते के बैलेंस की सभी गतिविधियाँ लौटाता है, नवीनतम पहले — खरीद, जमा, रिफंड और शुल्क एक ही सूची में। ऑर्डर, इनवॉइस और सक्रियण प्रत्येक केवल अपना हिस्सा दिखाते हैं, इसलिए यही एकमात्र एंडपॉइंट है जहाँ गणित पूरा बैठता है: किसी अवधि में delta_trx का योग उसी अवधि में बैलेंस के परिवर्तन के बराबर होता है।

स्कोप के बारे में। view स्कोप खरीद, रिफंड और शुल्क लौटाता है। जमा गतिविधियों के लिए अतिरिक्त रूप से deposit_view स्कोप और निकासी के लिए withdraw आवश्यक है; इनके बिना वे पंक्तियाँ सूची और total दोनों में नहीं आतीं, और ऐसे कारण से फ़िल्टर करने पर त्रुटि नहीं, बल्कि खाली पृष्ठ मिलता है।

क्वेरी पैरामीटर

number

डिफ़ॉल्ट:"1"

पृष्ठ संख्या, 1 से शुरू।

number

डिफ़ॉल्ट:"50"

प्रति पृष्ठ आइटम (अधिकतम 100)।

string

केवल इस कारण वाली गतिविधियाँ लौटाएँ, जैसे energy_order।

रिस्पॉन्स

array

दिखाएं item

number

गतिविधि ID। यही क्रम की कुंजी भी है — सूची इसके अवरोही क्रम में आती है।

string

TRX में राशि, चिह्न सहित: ऋणात्मक शुल्क है, धनात्मक जमा है।

string

इस गतिविधि के तुरंत बाद आपका बैलेंस।

string

गतिविधि किसलिए थी (नीचे देखें)। समय के साथ नए कारण आ सकते हैं — अज्ञात मान पर विफल होने के बजाय उसे वैसे ही दिखाएँ।

string | null

वह इकाई जिसके लिए भुगतान हुआ: order, invoice, activation, deposit आदि। कुछ भी संदर्भित न होने पर null।

string | null

उस इकाई की ID, स्ट्रिंग के रूप में।

string | null

उस इकाई का प्राप्तकर्ता पता, यदि हो — ताकि शुल्क का कारण जानने के लिए दूसरा अनुरोध न करना पड़े। अन्यथा null।

string

गतिविधि कब हुई (UTC)।

number

फ़िल्टर से मेल खाती कुल गतिविधियाँ।

number

पृष्ठ संख्या, 1 से शुरू।

number

प्रति पृष्ठ आइटम (अधिकतम 100)।

सामान्य कारण

कारण	अर्थ
`energy_order`	एनर्जी की खरीद
`bw_order`	बैंडविड्थ की खरीद
`energy_order_refund`	एनर्जी ऑर्डर का रिफंड
`bw_order_refund`	बैंडविड्थ ऑर्डर का रिफंड
`activation`	प्राप्तकर्ता खाते का चेन पर निर्माण
`activation_refund`	न हुई सक्रियता का रिफंड
`deposit`	आने वाली जमा

उदाहरण

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
}

बैलेंस इतिहास

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

बैंडविड्थ रेंटल (ऑटो-रिन्यू)

ऑर्डर

इनवॉइस

Smart Mode

ट्रांसफर पैकेज

खाता

Webhooks

बैलेंस इतिहास

बैलेंस इतिहास

क्वेरी पैरामीटर

रिस्पॉन्स

सामान्य कारण

उदाहरण

​बैलेंस इतिहास

​क्वेरी पैरामीटर

​रिस्पॉन्स

​सामान्य कारण

​उदाहरण

बैलेंस इतिहास

क्वेरी पैरामीटर

रिस्पॉन्स

सामान्य कारण

उदाहरण