flip/solana-models
1
0
Fork 0
mirror of https://github.com/FlipsideCrypto/solana-models.git synced 2026-02-06 11:47:08 +00:00
Code Issues Actions 14 Packages Projects Releases Wiki Activity
5399165667
solana-models/models/descriptions/tables/fact_sol_balances.md
tarikceric 5399165667
An 6390/llm context descriptions (#855) 
* description rules and fact_txs update

* blocks update

* idls and labels

* wip

* wip

* update desc

* update

* update doc rules

* update table desc per new rules

* updates
2025-07-16 12:26:39 -07:00

1.7 KiB
Raw Blame History

{% docs fact_sol_balances %}

Description

This table contains one row per account and transaction where a native SOL (Solana) balance changes on the Solana blockchain. It tracks pre- and post-transaction balances for each account, including block, transaction, mint, and owner information. Balances are adjusted for SOL's 9 decimal places. Each row represents a unique account-transaction balance change event, enabling analysis of SOL balance changes, account activity, and ownership attribution at the transaction level.

Key Use Cases

  • Analyze SOL balance changes and account activity
  • Attribute SOL balances and transfers to the correct owner at any point in time
  • Support analytics on SOL flows, DeFi protocol activity, and wallet histories
  • Study SOL distribution, holder analysis, and whale tracking
  • Enable time-series and event-based analytics on SOL balances

Important Relationships

  • Closely related to core.fact_token_account_owners (for historical ownership), core.fact_events (for event context), and core.fact_transfers (for transfer events)
  • Use core.fact_token_account_owners to attribute balances to the correct owner
  • Use core.fact_events for event-level context and protocol interactions
  • Use core.fact_transfers for asset movement and transfer analytics
  • Joins with core.fact_blocks for block context and core.fact_transactions for transaction context

Commonly-used Fields

  • block_timestamp: For time-series and balance change analysis
  • block_id, tx_id, tx_index: For unique identification and joins
  • account_address, mint, owner: For account, token, and ownership analytics
  • pre_balance, balance: For before/after balance analysis

{% enddocs %}