Skip to main content

Hourly Fee Agg Account

Table Metadata​

PropertyConfiguration
Natural Key(s)hour_agg, fee_source_account
Partition Field(s)hour_agg (DAY partition)
Clustered Field(s)hour_agg, fee_source_account
Documentationdbt docs

Column Details​

NameDescriptionData TypeDomain ValuesRequired?Notes
hour_aggHour-truncated UTC timestamp of the aggregation window. Derived from timestamp_trunc(closed_at, hour).TIMESTAMPYes
fee_source_accountThe account that paid the transaction fee. For fee-bump transactions, this is the fee sponsor (fee_account). For non-fee-bump transactions, this is the transaction originator (txn_account).STRINGYes
txn_countTotal number of transactions (Classic + Soroban) submitted by this fee_source_account in the hour.INTEGERYes
failed_txn_countNumber of failed transactions (Classic + Soroban) for this fee_source_account in the hour. Failed transactions are still charged fees and included in all fee aggregates.INTEGERNo
total_fee_chargedSum of fee_charged across all transactions (Classic + Soroban) for this fee_source_account in the hour. This is the total fees actually paid.INTEGERYes
total_max_feeSum of the effective fee ceiling -- coalesce(new_max_fee, max_fee) -- across all transactions for this fee_source_account in the hour. For fee-bump transactions, new_max_fee is the actual ceiling used by the network. Represents total willingness-to-pay.INTEGERYes
fee_efficiencyRatio of total_fee_charged to total_max_fee. Bounded (0, 1]. Values closer to 1.0 indicate the account is bidding close to what it actually pays; lower values indicate overbidding.FLOATNo
total_effective_operation_countTotal effective operations across all transactions for this fee_source_account. Adds 1 to the operation count for fee-bump transactions.INTEGERYes
total_raw_operation_countTotal raw operations (txn_operation_count) across all transactions for this fee_source_account. Does NOT include fee-bump adjustment.INTEGERYes
classic_txn_countNumber of Classic transactions for this fee_source_account in the hour. Classic transactions have resource_fee = 0.INTEGERNo
classic_failed_txn_countNumber of failed Classic transactions for this fee_source_account in the hour.INTEGERNo
classic_total_fee_chargedSum of fee_charged across Classic transactions for this fee_source_account. For Classic txns, fee_charged is the inclusion fee (no resource_fee component). NULL if the account had no Classic transactions in this hour.INTEGERNo
classic_total_max_feeSum of the effective fee ceiling -- coalesce(new_max_fee, max_fee) -- across Classic transactions for this fee_source_account. Represents Classic willingness-to-pay. NULL if the account had no Classic transactions in this hour.INTEGERNo
classic_total_effective_operation_countTotal effective operations across Classic transactions for this fee_source_account. Adds 1 for fee-bump transactions. NULL if the account had no Classic transactions in this hour.INTEGERNo
classic_surge_txn_countNumber of Classic transactions for this fee_source_account where fee_charged exceeded the base fee (effective_operation_count * 100 stroops), indicating surge pricing.INTEGERNo
soroban_txn_countNumber of Soroban transactions for this fee_source_account in the hour. Soroban transactions have resource_fee > 0.INTEGERNo
soroban_failed_txn_countNumber of failed Soroban transactions for this fee_source_account in the hour. Even failed Soroban transactions are charged inclusion_fee_charged and non_refundable_resource_fee_charged.INTEGERNo
soroban_total_fee_chargedSum of fee_charged across Soroban transactions for this fee_source_account. fee_charged = inclusion_fee_charged + non_refundable_resource_fee_charged + refundable_resource_fee_charged - resource_fee_refund. NULL if the account had no Soroban transactions in this hour.INTEGERNo
soroban_total_inclusion_fee_chargedSum of inclusion_fee_charged across Soroban transactions for this fee_source_account. NULL if the account had no Soroban transactions in this hour.INTEGERNo
soroban_total_inclusion_fee_bidSum of inclusion_fee_bid across Soroban transactions for this fee_source_account. Represents total willingness-to-pay for inclusion. NULL if the account had no Soroban transactions in this hour.INTEGERNo
soroban_total_resource_feeSum of resource_fee (pre-execution budget) across Soroban transactions for this fee_source_account. NULL if the account had no Soroban transactions in this hour.INTEGERNo
soroban_total_non_refundable_resource_feeSum of non_refundable_resource_fee_charged across Soroban transactions. Covers CPU instructions, read bytes, write bytes, and bandwidth. Charged regardless of tx success/failure. NULL if the account had no Soroban transactions in this hour.INTEGERNo
soroban_total_refundable_resource_feeSum of refundable_resource_fee_charged across Soroban transactions. Covers rent, events, and return value. Based on actual usage; 0 for failed transactions. NULL if the account had no Soroban transactions in this hour.INTEGERNo
soroban_total_rent_feeSum of rent_fee_charged across Soroban transactions. The portion of refundable_resource_fee_charged that went to ledger entry TTL extensions. NULL if the account had no Soroban transactions in this hour.INTEGERNo
soroban_total_resource_fee_refundSum of resource_fee_refund across Soroban transactions. Represents the unused portion of resource_fee returned to the account after execution. NULL if the account had no Soroban transactions in this hour.INTEGERNo
soroban_total_effective_operation_countTotal effective operations across Soroban transactions for this fee_source_account. Adds 1 for fee-bump transactions. NULL if the account had no Soroban transactions in this hour.INTEGERNo
soroban_surge_txn_countNumber of Soroban transactions for this fee_source_account where inclusion_fee_charged exceeded the base fee (effective_operation_count * 100 stroops), indicating surge pricing.INTEGERNo
airflow_start_tsTimestamp when the Airflow DAG run started. Used for pipeline metadata and debugging.STRINGNo