Skip to main content
Schema: stellar.core Table: fact_trust_lines Type: Base Table

What

FACT_TRUST_LINES table captures trust relationship events and balance states at time of transaction activity on the Stellar network. Each record represents the trustline state (balance, limits, liabilities) for an account-asset pair as recorded when a transaction affecting that trustline occurred. NOTE: This is NOT a comprehensive daily snapshot of all account balances - it only contains records when trustlines are created, modified, or involved in transactions. To reconstruct the current or historical balance state for analysis, you must identify the most recent record per account-asset pair using techniques like ROW_NUMBER() OVER (PARTITION BY account_id, asset_id ORDER BY ledger_sequence DESC). The table includes balance changes triggered by payments, trades, trustline modifications, and other operations, but accounts with no recent activity will not have recent records. Key data points include ASSET_CODE, ASSET_ISSUER, BALANCE (at transaction time), TRUST_LINE_LIMIT, BUYING_LIABILITIES, and SELLING_LIABILITIES. The DELETED flag indicates trustline removal. This transactional approach means supply calculations require careful aggregation of the latest state per account to avoid double-counting and to account for inactive accounts not represented in recent data.

Columns

Column NameData TypeDescription
ACCOUNT_IDTEXTACCOUNT_ID column
CLOSED_ATTIMESTAMP_NTZCLOSED_AT column
BLOCK_TIMESTAMPTIMESTAMP_NTZBLOCK_TIMESTAMP column
ASSET_IDNUMBERASSET_ID column
ASSET_TYPETEXTASSET_TYPE column
ASSET_ISSUERTEXTASSET_ISSUER column
ASSET_CODETEXTASSET_CODE column
LIQUIDITY_POOL_IDTEXTLIQUIDITY_POOL_ID column
BALANCEFLOATBALANCE column
TRUST_LINE_LIMITFLOATTRUST_LINE_LIMIT column
BUYING_LIABILITIESFLOATBUYING_LIABILITIES column
SELLING_LIABILITIESFLOATSELLING_LIABILITIES column
FLAGSTEXTFLAGS column
LAST_MODIFIED_LEDGERNUMBERLAST_MODIFIED_LEDGER column
LEDGER_ENTRY_CHANGENUMBERLEDGER_ENTRY_CHANGE column
DELETEDBOOLEANDELETED column
LEDGER_SEQUENCENUMBERLEDGER_SEQUENCE column
LEDGER_KEYTEXTLEDGER_KEY column
SPONSORTEXTSPONSOR column
BATCH_IDTEXTBATCH_ID column
BATCH_RUN_DATETIMESTAMP_NTZBATCH_RUN_DATE column
BATCH_INSERT_TSTIMESTAMP_NTZBATCH_INSERT_TS column
FACT_TRUST_LINES_IDTEXTFACT_TRUST_LINES_ID column
INSERTED_TIMESTAMPTIMESTAMP_NTZINSERTED_TIMESTAMP column
MODIFIED_TIMESTAMPTIMESTAMP_NTZMODIFIED_TIMESTAMP column