Monthly Stats

Retrieve a buyer account's monthly trading statistics for the last 6 months. Requires a whitelisted API key.

Retrieve detailed monthly statistics and trading activity for the buyer account. This endpoint returns per-month order counts and TRX deposit totals for the most recent 6 months.

Whitelist required This endpoint is only available to whitelisted addresses. Log in to TronSave and send your wallet address to the support team so it can be added to the whitelist. Once whitelisted, use the API key generated from that wallet address to call this endpoint.

Contact support via Telegram: @wantingtrx

Endpoint

GET https://api.tronsave.io/v2/internal/buyer/monthly-stats

Rate limit: 15 requests per 1 second.

Headers

Name

Type

Description

apikey*

String

TronSave API key. Must belong to a whitelisted address. See Authentication to get your API key.

* Required.

Request body

This endpoint takes no request body — pass the apikey header only.

Response

A successful response returns error: false and the statistics window in data.

Field

Type

Description

data.fromMonth

String

Oldest month in the result window, formatted as YYYY-MM.

data.toMonth

String

Current month, formatted as YYYY-MM.

data.monthCount

Number

Total number of months in the data array.

data.timezone

String

Timezone applied to all month boundaries — always UTC.

data.data[].month

String

Month identifier, formatted as YYYY-MM.

data.data[].totalOrder

Number

Total number of orders placed in the month.

data.data[].totalOrderEnergy

Number

Number of Energy orders placed in the month.

data.data[].totalOrderBW

Number

Number of Bandwidth orders placed in the month.

data.data[].totalTrxDepositToCreateBuyOrder

Number

Total TRX spent to create buy orders in the month.

data.data[].totalTrxDepositInternal

Number

Total TRX deposited into the internal account in the month.

200: OK

{
    "error": false,
    "message": "Success",
    "data": {
        "fromMonth": string, // oldest month in the result window, formatted as YYYY-MM
        "toMonth": string, // current month, formatted as YYYY-MM
        "monthCount": number, // Total number of months in the data array
        "timezone": string, // Timezone applied to all month boundaries — always UTC
        "data": [
            {
                "month": string, // Month identifier, formatted as YYYY-MM
                "totalOrder": number, // Total number of orders placed in the month
                "totalOrderEnergy": number, // Number of energy orders placed in the month
                "totalOrderBW": number, // Number of bandwidth orders placed in the month
                "totalTrxDepositToCreateBuyOrder": number, // Total TRX spent to create buy orders in the month
                "totalTrxDepositInternal": number // Total TRX deposited into the internal account in the month
            }
        ]
    }
}

Success example

{
    "error": false,
    "message": "Success",
    "data": {
        "fromMonth": "2025-12",
        "toMonth": "2026-05",
        "monthCount": 6,
        "timezone": "UTC",
        "data": [
            {
                "month": "2026-05",
                "totalOrder": 16,
                "totalOrderEnergy": 13,
                "totalOrderBW": 3,
                "totalTrxDepositToCreateBuyOrder": 1080.88,
                "totalTrxDepositInternal": 2000
            },
            {
                "month": "2026-04",
                "totalOrder": 23,
                "totalOrderEnergy": 23,
                "totalOrderBW": 0,
                "totalTrxDepositToCreateBuyOrder": 99.6,
                "totalTrxDepositInternal": 164
            }
        ]
    }
}

Errors

The apikey The header was not provided.

{
    "error": true,
    "message": "TSAS:106 API_KEY_REQUIRED",
    "data": null
}

Request examples

curl -X GET "https://api.tronsave.io/v2/internal/buyer/monthly-stats" \
  -H "apikey: YOUR_API_KEY"

const TRONSAVE_API_URL = "https://api.tronsave.io";

const getMonthlyStats = async (apiKey) => {
  const url = `${TRONSAVE_API_URL}/v2/internal/buyer/monthly-stats`;
  const res = await fetch(url, {
    headers: {
      apikey: apiKey,
    },
  });
  return res.json();
};

getMonthlyStats("YOUR_API_KEY").then(console.log);

import requests

TRONSAVE_API_URL = "https://api.tronsave.io"
API_KEY = "YOUR_API_KEY"


def get_monthly_stats() -> dict:
    """Get buyer monthly statistics (last 6 months)."""
    url = f"{TRONSAVE_API_URL}/v2/internal/buyer/monthly-stats"
    headers = {"apikey": API_KEY}
    response = requests.get(url, headers=headers)
    return response.json()


print(get_monthly_stats())

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class GetMonthlyStats {
    static final String TRONSAVE_API_URL = "https://api.tronsave.io";
    static final String API_KEY = "YOUR_API_KEY";

    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(TRONSAVE_API_URL + "/v2/internal/buyer/monthly-stats"))
                .header("apikey", API_KEY)
                .GET()
                .build();

        HttpResponse<String> response =
                client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

package main

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

const (
	tronsaveAPIURL = "https://api.tronsave.io"
	apiKey         = "YOUR_API_KEY"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, tronsaveAPIURL+"/v2/internal/buyer/monthly-stats", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("apikey", apiKey)

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

use serde_json::Value;

const TRONSAVE_API_URL: &str = "https://api.tronsave.io";
const API_KEY: &str = "YOUR_API_KEY";

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = reqwest::blocking::Client::new();
    let resp: Value = client
        .get(format!("{TRONSAVE_API_URL}/v2/internal/buyer/monthly-stats"))
        .header("apikey", API_KEY)
        .send()?
        .json()?;

    println!("{resp:#?}");
    Ok(())
}

Next steps

Get Internal Account Info — check your internal account balance and deposit address.
Get Order Book — fetch current resource pricing and availability.
Authentication — how to pass your API key on each request.

PreviousList Orders NextExtend Orders

Last updated 3 days ago