Skip to content

Add ton.balances_history table documentation #678

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 27 additions & 0 deletions data-catalog/ton/balances_history.mdx
Original file line number Diff line number Diff line change
@@ -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" />
4 changes: 4 additions & 0 deletions data-catalog/ton/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand Down
1 change: 1 addition & 0 deletions mint.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down