From 5b161b3c7889e9eaebe1dbdf9d31deacc7107828 Mon Sep 17 00:00:00 2001
From: Pavel Shuvalov <pavel.s@ton.org>
Date: Wed, 7 May 2025 17:52:12 +0400
Subject: [PATCH] Add ton.balances_history table documentation

---
 data-catalog/ton/balances_history.mdx | 27 +++++++++++++++++++++++++++
 data-catalog/ton/overview.mdx         |  4 ++++
 mint.json                             |  1 +
 3 files changed, 32 insertions(+)
 create mode 100644 data-catalog/ton/balances_history.mdx

diff --git a/data-catalog/ton/balances_history.mdx b/data-catalog/ton/balances_history.mdx
new file mode 100644
index 00000000..2e206179
--- /dev/null
+++ b/data-catalog/ton/balances_history.mdx
@@ -0,0 +1,27 @@
+---
+title: ton.balances_history
+sidebarTitle: "Balances history"
+description: Description of the ton.balances_history table on Dune
+---
+
+## Table Description
+Contains information about all balances changes for native TON and jettons. This table allows
+to get point time balance for each address as well latest balances.
+
+## Column Descriptions
+| **Column**           | **Type**      | **Description**                                                       |
+|----------------------|---------------|-----------------------------------------------------------------------|
+| **block_time**       | timestamp     | Timestamp of when the block containing the balance change was created |
+| **block_date**       | date          | Date of when the block containing the balance change was created      |
+| **address**          | string        | Account raw address                                                   |
+| **asset**            | string        | Asset address or __TON__ for TON balance                              |
+| **amount**           | decimal(38,0) | Asset balance                                                         |
+| **mintless_claimed** | boolean       | Special flag for mintless jettons that mintless part was claimed      |
+| **timestamp**        | int           | Unix timestamp of the transaction                                     |
+| **lt**               | bigint        | Logical time of the transaction                                       |
+
+## Table Sample
+
+import { TableSample } from "/snippets/table-sample.mdx";
+
+<TableSample tableSchema="ton" tableName="balances_history" />
\ No newline at end of file
diff --git a/data-catalog/ton/overview.mdx b/data-catalog/ton/overview.mdx
index 44279a5b..0bdcd3bd 100644
--- a/data-catalog/ton/overview.mdx
+++ b/data-catalog/ton/overview.mdx
@@ -31,6 +31,10 @@ TON blockchain data is organized into several key tables that capture different
     Inter-contract messages and value transfers between accounts.
   </Card>
 
+  <Card title="Balances history" icon="book" href="/data-catalog/ton/balances_history">
+    TON and jettons balances history.
+  </Card>
+
   <Card title="DEX Pools" icon="water" href="/data-catalog/ton/dex_pools">
     Liquidity pool configurations and statistics from decentralized exchanges.
   </Card>
diff --git a/mint.json b/mint.json
index 1a2f2c73..3ab4e610 100644
--- a/mint.json
+++ b/mint.json
@@ -2244,6 +2244,7 @@
           "pages": [
             "data-catalog/ton/overview",
             "data-catalog/ton/accounts",
+            "data-catalog/ton/balances_history",
             "data-catalog/ton/blocks",
             "data-catalog/ton/transactions",
             "data-catalog/ton/messages",