Skip to main content

Ledger Fee Stats Agg

Table Metadata​

PropertyConfiguration
Natural Key(s)ledger_sequence
Partition Field(s)N/A
Clustered Field(s)day_agg, ledger_sequence
Documentationdbt docs

Column Details​

NameDescriptionData TypeDomain ValuesRequired?Notes
day_aggDay when the ledger fee stats were aggregated.DATEYes
ledger_sequenceThe unique ledger sequence number. This is the grain of the table -- one row per ledger.INTEGERYes
total_fee_chargedSum of fee_charged across all transactions (Classic + Soroban) in the ledger. This is the total fees actually paid.INTEGERYes
max_fee_chargedMaximum fee_charged across all transactions (Classic + Soroban) in the ledger.INTEGERYes
txn_countTotal number of transactions (Classic + Soroban) in the ledger.INTEGERYes
failed_txn_countNumber of failed transactions (Classic + Soroban) in the ledger. Failed transactions are still included in all fee aggregates because inclusion_fee_charged and non_refundable_resource_fee_charged are charged regardless of transaction success.INTEGERNo
total_effective_txn_operation_countTotal number of effective operations across all transactions in the ledger. Uses effective_txn_operation_count, which adds 1 for fee-bump transactions to account for the extra inner transaction.INTEGERYes
total_raw_txn_operation_countTotal number of raw operations (txn_operation_count) across all transactions in the ledger. Unlike effective operation count, this does NOT include fee-bump transactions.INTEGERYes
classic_txn_countNumber of Classic transactions in the ledger. Classic transactions have resource_fee = 0.INTEGERNo
classic_failed_txn_countNumber of failed Classic transactions in the ledger.INTEGERNo
classic_total_effective_operation_countTotal number of effective operations across Classic transactions in the ledger. Adds 1 for fee-bump transactions.INTEGERNo
classic_total_raw_operation_countTotal number of raw operations across Classic transactions in the ledger. Does NOT include fee-bump transactions.INTEGERNo
classic_sum_fee_chargedSum of fee_charged across Classic transactions. For Classic txns, fee_charged is the inclusion fee (no resource_fee component).INTEGERNo
classic_max_fee_chargedMaximum fee_charged across Classic transactions in the ledger.INTEGERNo
classic_sum_max_feeSum of COALESCE(new_max_fee, max_fee) across Classic transactions. Represents total willingness-to-pay.INTEGERNo
classic_max_max_feeMaximum of COALESCE(new_max_fee, max_fee) across Classic transactions in the ledger.INTEGERNo
classic_max_inclusion_fee_per_opMaximum inclusion fee per operation (fee_charged / effective_txn_operation_count) across Classic transactions. Fee-bump txns add 1 to the operation count.FLOATNo
classic_min_inclusion_fee_per_opMinimum inclusion fee per operation across Classic transactions in the ledger.FLOATNo
classic_surge_txn_countNumber of Classic transactions in the ledger where fee_charged exceeded the base fee (100 stroops per operation), indicating surge pricing.INTEGERNo
classic_surge_operation_countTotal operations in Classic transactions that experienced surge pricing in the ledger.INTEGERNo
classic_is_surge_ledgerTrue if any Classic transaction in the ledger experienced surge pricing.BOOLEANNo
soroban_txn_countNumber of Soroban transactions in the ledger. Soroban transactions have resource_fee > 0.INTEGERNo
soroban_failed_txn_countNumber of failed Soroban transactions in the ledger. Even failed Soroban transactions are charged inclusion_fee_charged and non_refundable_resource_fee_charged, so they are included in all fee aggregates.INTEGERNo
soroban_total_effective_operation_countTotal number of effective operations across Soroban transactions in the ledger. Adds 1 for fee-bump transactions.INTEGERNo
soroban_total_raw_operation_countTotal number of raw operations across Soroban transactions in the ledger. Does NOT include fee-bump transactions.INTEGERNo
soroban_sum_fee_chargedSum of fee_charged across Soroban transactions. fee_charged = inclusion_fee_charged + non_refundable_resource_fee_charged + refundable_resource_fee_charged.INTEGERNo
soroban_max_fee_chargedMaximum fee_charged across Soroban transactions in the ledger.INTEGERNo
soroban_sum_inclusion_fee_chargedSum of inclusion_fee_charged across Soroban transactions. The base inclusion fee is 100 stroops per operation. If inclusion_fee_charged exceeds this base, the ledger experienced inclusion fee surge pricing.INTEGERNo
soroban_max_inclusion_fee_chargedMaximum inclusion_fee_charged across Soroban transactions in the ledger.INTEGERNo
soroban_sum_inclusion_fee_bidSum of inclusion_fee_bid across Soroban transactions. inclusion_fee_bid = COALESCE(new_max_fee, max_fee) - resource_fee.INTEGERNo
soroban_max_inclusion_fee_bidMaximum inclusion_fee_bid across Soroban transactions in the ledger.INTEGERNo
soroban_max_inclusion_fee_per_opMaximum inclusion fee per operation (inclusion_fee_charged / effective_txn_operation_count) across Soroban transactions in the ledger.FLOATNo
soroban_min_inclusion_fee_per_opMinimum inclusion fee per operation across Soroban transactions in the ledger.FLOATNo
soroban_sum_resource_feeSum of resource_fee (the pre-execution budget for Soroban resource consumption) across Soroban transactions in the ledger.INTEGERNo
soroban_max_resource_feeMaximum resource_fee across Soroban transactions in the ledger.INTEGERNo
soroban_min_resource_feeMinimum resource_fee across Soroban transactions in the ledger.INTEGERNo
soroban_sum_non_refundable_resource_fee_chargedSum of non_refundable_resource_fee_charged across Soroban transactions. Covers CPU instructions, read bytes, write bytes, and bandwidth. Charged based on declared resources regardless of tx success/failure.INTEGERNo
soroban_max_non_refundable_resource_fee_chargedMaximum non_refundable_resource_fee_charged across Soroban transactions in the ledger.INTEGERNo
soroban_min_non_refundable_resource_fee_chargedMinimum non_refundable_resource_fee_charged across Soroban transactions in the ledger.INTEGERNo
soroban_sum_refundable_resource_fee_chargedSum of refundable_resource_fee_charged across Soroban transactions. Covers rent, events, and return value. Based on actual usage; 0 for failed transactions.INTEGERNo
soroban_max_refundable_resource_fee_chargedMaximum refundable_resource_fee_charged across Soroban transactions in the ledger.INTEGERNo
soroban_min_refundable_resource_fee_chargedMinimum refundable_resource_fee_charged across Soroban transactions in the ledger.INTEGERNo
soroban_sum_resource_fee_refundSum of resource_fee_refund across Soroban transactions. NOTE: Currently broken -- always 0.INTEGERNo
soroban_max_resource_fee_refundMaximum resource_fee_refund across Soroban transactions. NOTE: Currently broken -- always 0.INTEGERNo
soroban_min_resource_fee_refundMinimum resource_fee_refund across Soroban transactions. NOTE: Currently broken -- always 0.INTEGERNo
soroban_sum_rent_fee_chargedSum of rent_fee_charged across Soroban transactions. This is the portion of refundable_resource_fee_charged that went to ledger entry TTL extensions.INTEGERNo
soroban_max_rent_fee_chargedMaximum rent_fee_charged across Soroban transactions in the ledger.INTEGERNo
soroban_min_rent_fee_chargedMinimum rent_fee_charged across Soroban transactions in the ledger. Will be 0 for ledgers where all Soroban transactions failed.INTEGERNo
soroban_surge_txn_countNumber of Soroban transactions in the ledger where inclusion_fee_charged exceeded the base fee (100 stroops per operation), indicating surge pricing.INTEGERNo
soroban_surge_operation_countTotal operations in Soroban transactions that experienced surge pricing in the ledger.INTEGERNo
soroban_is_surge_ledgerTrue if any Soroban transaction in the ledger experienced surge pricing.BOOLEANNo
closed_atTimestamp in UTC when the ledger closed and was committed to the network. Sourced from history_ledgers.TIMESTAMPNo
fee_poolThe total fee pool for the ledger, sourced from history_ledgers.INTEGERNo
airflow_start_tsTimestamp when the Airflow DAG run started. Used for pipeline metadata and debugging.STRINGNo