Skip to main content

Enriched History Operations

NameDescriptionData TypeDomain ValuesPrimary Key?Natural Key?Partition or Cluster Field?Required?Source TableNotes
accountThe new resulting account address that is created and funded (create operation) The account address that is being removed and merged into another account (merge operation)stringhistory_operationsPart of the original `details` object in the history_operations table
amountFloat representation of the amount of an asset sent/offered/etcfloathistory_operations
asset_codeThe 4 or 12 character code representation of the asset on the networkstringhistory_operations
asset_issuerThe account address of the original asset issuer that created the assetstringhistory_operations
asset_typeThe identifier for type of asset code, can be a alphanumeric with 4 characters, 12 characters or the native asset to the network, XLM.stringcredit_alphanum4 credit_alphanum12 nativehistory_operations
authorizeIndicates whether the trustline is authorized. 0 is the account is not authorized to transact with the asset in any way. 1 if the account is authorized to transact with the asset. 2 if the account is authorized to maintain orders, but not to perform other transactions.booleanhistory_operations
balance_idThe unique identifier of the claimable balance. The id is comprised of 8 character type code + SHA-256 hash of the history operation id that created the balance. The balance id can be joined back to the `claimable_balances` table to gather more details about the balancestringhistory_operations
buying_asset_codeThe 4 or 12 character code representation of the asset that is either bought or offered to buy in a tradestringhistory_operations
buying_asset_issuerThe account address of the original asset issuer that created the asset bought or offered to buystringhistory_operations
buying_asset_typeThe identifier for type of asset code, can be a alphanumeric with 4 characters, 12 characters or the native asset to the network, XLM.stringcredit_alphanum4 credit_alphanum12 nativehistory_operations
fromThe account address from which the payment originates (the sender account)stringhistory_operations
funderWhen a new account is created, an account address "funds" the new accountstringhistory_operations
high_thresholdThe sum of the weight of all signatures that sign a transaction for the high threshold operation. The weight must exceed the set threshold for the operation to succeed.integerhistory_operationsEach operation falls under a specific threshold category: low, medium or high. Thresholds define the level of privilege an operation needs in order to succeed (this is a security measure) Low Security: Allow Trust, Set Trust Line Flags, Bump Sequence and Claim Claimable Balance Medium Security: Everything Else High Security: Account Merge, Set Options
home_domainThe home domain used for the stellar.toml file discoverystringhistory_operations
inflation_destThe account address specifying where to send inflation funds. The concept of inflation on the network has been discontinuedstringhistory_operationsInflation was retired from the network in 2019.
intoThe account address receiving the deleted account's lumens. This is the account in which the intended deleted account will be mergedstringhistory_operations
limitThe upper bound amount of an asset that an account can holdfloathistory_operations
low_thresholdThe sum of the weight of all signatures that sign a transaction for the low threshold operation. The weight must exceed the set threshold for the operation to succeed.integerhistory_operationsEach operation falls under a specific threshold category: low, medium or high. Thresholds define the level of privilege an operation needs in order to succeed (this is a security measure) Low Security: Allow Trust, Set Trust Line Flags, Bump Sequence and Claim Claimable Balance Medium Security: Everything Else High Security: Account Merge, Set Options
master_key_weightAn accounts private key is called the master key. For signing transactions, the account holder can specify a weight for the master key, which contributes to thresholds validation when processing a transactionintegerIntegers from 1 to 255history_operations
med_thresholdThe sum of the weight of all signatures that sign a transaction for the medium threshold operation. The weight must exceed the set threshold for the operation to succeed.integerhistory_operationsEach operation falls under a specific threshold category: low, medium or high. Thresholds define the level of privilege an operation needs in order to succeed (this is a security measure) Low Security: Allow Trust, Set Trust Line Flags, Bump Sequence and Claim Claimable Balance Medium Security: Everything Else High Security: Account Merge, Set Options
nameThe manage data operation allows an account to write and store data directly on the ledger in a key value pair format. The name is the key for a data entry.stringhistory_operations
offer_idThe unique id for the offer. This id can be joined with the `offers` tableintegerhistory_operations
pathPath payments maximize the best exchange rate path when sending money from one asset to another asset. The intermediary assets that this path hops through will be reported in the record. This feature is especially useful when the market between the original asset pair is illiquidarray[record]history_operationsUp to 6 paths are permitted for a single payment. Example: sending EUR -> MXN could look like EUR -> BTC -> CNY -> XLM -> MXN to maximize the best exchange rate Payments are atomic, so if an exchange in the middle of a path payment fails, the entire payment will fail which means the user will keep their original funds. They will not be stuck with an intermediary asset in the event of payment failure.
priceThe ratio of selling asset to buying asset. This is a number representing how many units of a selling asset it takes to get 1 unit of a buying assetfloathistory_operations
dPrecise representation of the buy and sell price of a trade. The `d` is the denominator. When taken with n/d you will get the priceintegerhistory_operations
nPrecise representation of the buy and sell prices of a trade. The `n` is the numerator. When taken with n/d you will get the price.integerhistory_operations
selling_asset_codeThe 4 or 12 character code representation of the asset that is either sold or offered to sell in a tradestringhistory_operations
selling_asset_issuerThe account address of the original asset issuer that created the asset sold or offered to sellstringhistory_operations
selling_asset_typeThe identifier for type of asset code, can be a alphanumeric with 4 characters, 12 characters or the native asset to the network, XLM.stringcredit_alphanum4 credit_alphanum12 nativehistory_operations
set_flagsArray of numeric values of the flags set for a given trustline in the operationarray[integer]1 - Auth Required 2 - Auth Revocable 4 - Auth Immutablehistory_operations
set_flags_sArray of string values of the flags set for a given trustline in the operationarray[string]Auth Required Auth Revocable Auth Immutablehistory_operations
signer_keyThe address of the signer which is no longer sponsoredstringhistory_operations
signer_weightThe weight of the new signer. For transactions, multiple accounts can sign a transaction from a source account. This weight contributes towards calculating whether the transaction exceeds the specified threshold weight to complete the transactionintegerhistory_operations
source_amountThe originating amount sent designated in the source assetfloathistory_operations
source_asest_codeThe 4 or 12 character code representation of the asset that is originally sentstringhistory_operations
source_asset_issuerThe account address of the original asset issuer that created the asset sentstringhistory_operations
source_asset_typeThe identifier for type of asset code, can be a alphanumeric with 4 characters, 12 characters or the native asset to the network, XLM.stringcredit_alphanum4 credit_alphanum12 nativehistory_operations
source_maxThe maxium amount to be sent, designated in the source assetfloathistory_operations
starting_balanceThe amount of XLM to send to the newly created account. The account starting balance will need to exceed the minimum balance necessary to hold an account on the Stellar Networkfloathistory_operations
toThe address of the account receiving the payment fundsstringhistory_operations
trusteeThe issuing account address (only present for `credit` asset types)stringhistory_operations
trustorThe trusting account address, or the account being authorized or unauthorizedstringhistory_operations
trustline_assetThe asset of the trustline which is no longer sponsoredstringhistory_operations
valueThe manage data operation allows an account to write and store data directly on the ledger in a key value pair format. The value is the value of a key for a data entry.stringhistory_operations
clear_flagsArray of numeric values of the flags cleared for a given trustline in the operation. If the flag was originally set, this will delete the flagarray[integer]1 - Auth Required 2 - Auth Revocable 4 - Auth Immutablehistory_operations
clear_flags_sArray of string values of the flags cleared for a given trustline in the operation. If the flag was originally set, this will delete the flagarray[string]Auth Required Auth Revocable Auth Immutablehistory_operations
destination_minThe minimum amount to be received, designated in the expected destination assetstringhistory_operations
bump_toThe new desired value of the source account's sequence numberstringhistory_operations
sponsorThe account address of another account that maintains the minimum balance in XLM for the source account to complete operationsstringhistory_operations
sponsored_idThe account address of the account which will be sponsoredstringhistory_operations
begin_sponsorThe account address of the account which initiated the sponsorshipstringhistory_operations
authorize_to_maintain_liabilitiesIndicates whether the trustline is authorized. 0 is the account is not authorized to transact with the asset in any way. 1 if the account is authorized to transact with the asset. 2 if the account is authorized to maintain orders, but not to perform other transactions.booleanhistory_operations
clawback_enabledIndicates whether the asset can be clawed back by the asset issuerbooleanhistory_operations
liquidity_pool_idUnique identifier for a liquidity poolstringhistory_operations
reserve_a_asset_typeThe identifier for type of asset code, can be a alphanumeric with 4 characters, 12 characters or the native asset to the network, XLM.stringcredit_alphanum4 credit_alphanum12 nativehistory_operations
reserve_a_asset_codeThe 4 or 12 character code representation of the asset of one of the two asset pairs in a liquidity poolstringhistory_operations
reserve_a_asset_issuerThe account address of the original asset issuer that created one of the two asset pairs in the liquidity poolstringhistory_operations
reserve_a_max_amountThe maximum amount of reserve a that can be deposited into the pool.floathistory_operations
reserve_a_deposit_amountThe amount of reserve a that ended up actually deposited into the poolfloathistory_operations
reserve_b_asset_typeThe identifier for type of asset code, can be a alphanumeric with 4 characters, 12 characters or the native asset to the network, XLM.stringcredit_alphanum4 credit_alphanum12 nativehistory_operations
reserve_b_asset_codeThe 4 or 12 character code representation of the asset of one of the two asset pairs in a liquidity poolstringhistory_operations
reserve_b_asset_issuerThe account address of the original asset issuer that created one of the two asset pairs in the liquidity poolstringhistory_operations
reserve_b_max_amountThe maximum amount of reserve b that can be deposited into the pool.floathistory_operations
reserve_b_deposit_amountThe amount of reserve b that ended up actually deposited into the pool.floathistory_operations
min_priceThe floating point value indicating the minimum exchange rate for this deposit operation. Reported as Reserve A / Reserve Bfloathistory_operations
min_price_rA fractional representation of the prices of the two assets in a pool. The n is the numerator (value of asset a) and the d is the denominator (value of asset b)array[record]history_operations
max_priceThe floating point value indicating the maximum exchange rate for this deposit operation. Reported as Reserve A / Reserve Bfloathistory_operations
max_price_rA fractional representation of the prices of the two assets in a pool. The n is the numerator (value of asset a) and the d is the denominator (value of asset b)array[record]history_operations
shares_receivedA floating point number representing the number of pool shares received for this deposit. A pool share is a compilation of both asset a and asset b reserves. It is not possible to own only asset a or asset b in a poolfloathistory_operations
reserve_a_min_amountThe minimum amount of reserve a that can be withdrawn from the pool.floathistory_operations
reserve_b_min_amountThe minimum amount of reserve b that can be withdrawn from the pool.floathistory_operations
sharesThe number of shares withdrawn from the pool. It is not possible to withdraw only asset a or asset b, equal value must be withdrawn from the poolfloathistory_operations
reserve_a_withdraw_amountThe amount of reserve a that ended up actually withdrawn from the pool.floathistory_operations
reserve_b_withdraw_amountThe amount of reserve b that ended up actually withdrawn from the pool.floathistory_operations
op_application_orderThe order number in the transaction set in which the operation is executed. The application order and transaction id is a natural key that comprises the (operation) idintegerhistory_operations
op_idUnique identifier for an operationintegerhistory_operations
op_source_accountThe account address that originates the operationstringhistory_operations
op_source_account_muxedIf an account is multiplexed (muxed), the virtual account address that originates the operationstringhistory_operations
transaction_idThe transaction identifier in which the operation executed. There can be up to 100 operations in a given transactionintegerhistory_operations
typeThe number indicating which type of operation this operation executesinteger0 - Create Account 1 - Payment 2 - Path Payment Strict Receive 3 - Manage Sell Offer 4 - Create Passive Sell Offer 5 - Set Options 6 - Change Trust 7 - Allow Trust 8 - Account Merge 9 - Inflation 10 - Manage Data 11 - Bump Sequence 12 - Manage Buy Offer 13 - Path Payment Strict Send 14 - Create Claimable Balance 15 - Claim Claimable Balance 16 - Being Sponsoring Future Reserves 17 - End Sponsoring Future Reserves 18 - Revoke Sponsorship 19 - Clawback 20 - Clawback Claimable Balance 21 - Set Trust Line Flags 22 - Liquidity Pool Deposit 23 - Liquidity Pool Withdrawhistory_operations
transaction_hashA hex-encoded SHA-256 hash of this transaction's XDR-encoded formstringhistory_transactions
ledger_sequenceThe sequence number of the ledger that this transaction was included inintegerhistory_transactions
txn_application_orderEach transaction within the transaction set for a ledger is executed and applied sequentially to the network. The validator nodes randomly shuffle submitted transactions and assign them an application order number, which corresponds to the order in which they are appliedintegerhistory_transactions
txn_accountThe account address that originates the transactionstringhistory_transactions
account_sequenceThe source account's sequence number that this transaction consumed. Sequence numbers can only be used once and help maintain atomicity and idempotency on the network.integerhistory_transactions
max_feeThe maximum fee (in stroops) that the source account is willing to pay for the transaction to be included in a ledger. When the network enters surge pricing, this helps determine if a transaction is included in the setintegerhistory_transactionsThe stroop is the fractional representation of a lumen (XLM). 1 stroop is 0.0000001 XLM.
txn_operation_countThe number of operations contained within this transactionintegerhistory_transactionsA transaction is permitted to have up to 100 operations
txn_created_atThe date the transaction was createdtimestamphistory_transactions
memo_typeThe type of memostringMemoTypeMemoHash MemoTypeMemoId MemoTypeMemoNone MemoTypeMemoReturn MemoTypeMemoTexthistory_transactionsDefaults to `MemoTypeMemoNone`
memoAn optional freeform field that attaches a memo to a transactionstringhistory_transactionsMemos are heavily used by centralized exchanges to help with account management.
time_boundsA transaction precondition that can be set to determine when a transaction is valid. The user can set a lower and upper timebound, defined as a UNIX timestamp when the transaction can be executed. If the transaction attempts to execute outside of the time range, the transaction will failstringhistory_transactions
successfulIndicates if this transaction was successful or notbooleanhistory_transactionsA transaction's success does not indicate whether it was included and written to a ledger. It only indicates whether the operations in the transaction were successfully applied to mutate the ledger state.
fee_chargedThe fee (in stroops) paid by the source account to apply this transaction to the ledger. At minimum, a transaction is charged # of operations * base fee. The minimum base fee is 100 stroopsintegerhistory_transactionsThe stroop is the fractional representation of a lumen (XLM). 1 stroop is 0.0000001 XLM.
fee_accountAn account that is not the originating source account for a transaction is allowed to pay transaction fees on behalf of the source account. These accounts are called fee accounts and incur all transaction costs for the source account.stringhistory_transactions
new_max_feeIf an account has a fee account, the fee account can specify a maximum fee (in stroops) that it is willing to pay for this account's fees. When the network is in surge pricing, the validators will consider the new_max_fee instead of the max_fee when determining if the transaction will be included in the transaction setintegerhistory_transactions
account_muxedIf the user has defined multiplexed (muxed) accounts, the account exists "virtually" under a traditional Stellar account address. This address distinguishes between the virtual accountsstringhistory_transactions
fee_account_muxedIf the fee account that sponsors fee is a multiplexed account, the virtual address will be listed herestringhistory_transactions
ledger_hashThe hex-encoded SHA-256 hash that represents the ledger's XDR-encoded formstringhistory_ledgers
previous_ledger_hashThe hex-encoded SHA-256 hash of the ledger that immediately precedes this ledgerstringhistory_ledgers
transaction_countThe number of successful transactions submitted and completed by the network in this ledgerintegerhistory_ledgers
ledger_operation_countThe total number of successful operations applied to this ledgerintegerhistory_ledgers
closed_atTimestamp in UTC when this ledger closed and committed to the network. Ledgers are expected to close ~every 5 secondstimestampMONTH partitionhistory_ledgers
ledger_idUnique identifier for the ledgerintegerhistory_ledgers
total_coinsTotal number of lumens in circulationintegerhistory_ledgers
fee_poolThe sum of all transaction feesintegerhistory_ledgers
base_feeThe fee (in stroops) the network charges per operation in a transaction for the given ledger. The minimum base fee is 100, with the ability to increase if transaction demand exceeds ledger capacity. When this occurs, the ledger enters surge pricingintegerhistory_ledgers
base_reserveThe reserve (in stroops) the network requires an account to retain as a minimum balance in order to be a valid account on the network. The current minimum reserve is 10 XLMinteger5000000 100000000history_ledgers
max_tx_set_sizeThe maximum number of operations that Stellar validator nodes have agreed to process in a given ledger. Since Protocol 11, ledger capacity has been measured in operations rather than transactionsinteger50 - original max 500 1000 - current maxhistory_ledgers
protocol_versionThe protocol verstion that the Stellar network was running when this ledger was committed. Protocol versions are released ~every 6 monthsintegerintegers 1 - 19 (will increment)history_ledgers
successful_transaction_countThe number of successful transactions submitted and completed by the network in this ledgerintegerhistory_ledgers
failed_transaction_countThe number of failed transactions submitted to the network in this ledger. The transaction was still paid for but contained an error that prevented it from executingintegerhistory_ledgers
batch_idString representation of the run id for a given DAG in Airflow. Takes the form of "scheduled__<batch_end_date>-<dag_alias>". Batch ids are unique to the batch and help with monitoring and rerun capabilitiesstringhistory_operations
batch_run_dateThe start date for the batch interval. When taken with the date in the batch_id, the date represents the interval of ledgers processed. The batch run date can be seen as a proxy of closed_at for a ledger.datetimehistory_operationsThe table is partitioned on batch_run_date. It is recommended to always include the batch_run_date in the filter if possible to help reduce query cost.
batch_insert_tsThe timestamp in UTC when a batch of records was inserted into the database. This field can help identify if a batch executed in real time or as part of a backfilltimestampcurrent timestamp
ledger_boundsA transaction precondition that can be set to determine valid conditions for a transaction to be submitted to the network. Ledger bounds allow the user to specify a minimum and maxiumum ledger sequence number in which the transaction can successfully executestringhistory_transactions
min_account_sequenceA transaction precondition that can be set to determine valid conditions for a transaction to be submitted to the network. This condition contains an integer representation of the lowest source account sequence number for which the transaction is validintegerhistory_transactions
min_account_sequence_ageA transaction precondition that can be set to determine valid conditions for a transaction to be submitted to the network. This condition contains a minimum duration of time that must have passed since the source account's sequence number changed for the transaction to be validintegerhistory_transactions
min_account_sequence_ledger_gapA transaction precondition that can be set to determine valid conditions for a transaction to be submitted to the network. This condition contains an integer representation of the minimum number of ledgers that must have closed since the source account's sequence number change for the transaction to be validintegerhistory_transactions
extra_signersAn array of up to two additional signers that must have corresponding signatures for this transaction to be validarray[string]history_transactions
asset_idUnique identifier for asset_code, asset_issuerhistory_operations
buying_asset_idUnique identifier for buying_asset_code, buying_asset_issuerhistory_operations
selling_asset_idUnique identifier for selling_asset_code, selling_asset_issuerhistory_operations
source_asset_idUnique identifier for source_asset_code, source_asset_issuerhistory_operations
reserve_a_asset_idUnique identifier for reserve_a_asset_code, reserve_a_asset_issuerhistory_operations
reserve_b_asset_idUnique identifier for reserve_b_asset_code, reserve_b_asset_issuerhistory_operations
asset_balance_changesThe balance changes applied to an account or contract from an invoke host function. An asset must be a classic asset transferred through the SAC to be included.recordhistory_operationsMore details about the record structure can be found in the `history_operations` tab
parametersThe parameters passed to the function call for a Soroban contract. These are base64 encoded XDR. The record follows the format of `type` + `value` pairrecordhistory_operationsMore details about the record structure can be found in the `history_operations` tab
parameters_decodedThe decoded human readable parameters passed to a function call for a Soroban contract. The record follows the format of `type` + `value` pairrecordhistory_operationsMore details about the record structure can be found in the `history_operations` tab
functionThe function type invoked by the host operationstringHostFunctionTypeHostFunctionTypeInvokeContract HostFunctionTypeHostFunctionTypeCreateContract HostFunctionTypeHostFunctionTypeUploadContractWasmhistory_operations
addressThe wallet address used to create and deploy a Soroban contract instance.stringhistory_operations
soroban_operation_typeThe type of Soroban operation that is invoked within a host functionstringinvoke_contract create_contract upload_wasm extend_footprint_ttl restore_footprinthistory_operations
extend_toThe number of ledgers in which the Soroban ledger entry is extendedintegerhistory_operations
contract_idThe unique identifier of the deployed contract instance. Each custom Soroban contract and deployed SAC token will have a unique contract_id.stringhistory_operations
contract_code_hashThe hex-encoded SHA-256 hash that represents the contract code's XDR-encoded formstringhistory_operations
resource_feeThe fee charged less the inclusion fee for the Soroban transaction. This is calculated by the read/write operations and how process intensive the Soroban transaction isintegerhistory_transactions
soroban_resources_instructionsNumber of CPU instructions the Soroban transaction usesintegerhistory_transactions
soroban_resources_read_bytesNumber of bytes read by the Soroban transactionintegerhistory_transactions
soroban_resources_write_bytesNumber of bytes written by the Soroban transactionintegerhistory_transactions
transaction_result_codeThe detailed result code that outlines why a transaction failed. This code is only useful for failed transactions. The full list of domain values can be found here.stringhistory_transactions
inclusion_fee_bidThe maximum bid the submitter is willing to pay for inclusion of the transaction. This fee is used to prioritize transactions that are included in the ledger.integerhistory_transactions
inclusion_fee_chargedThe fee charged for the transaction to be included in the ledger.integerhistory_transactions
resource_fee_refundThe amount of the resource fee refunded to the transaction submitter. The refundable fees are calculated from rent, events and return value. Refundable fees are charged from teh source account before the transaction is executed and then refunded based on the actual usage.integerhistory_transactions
operation_result_codeThe result code returned when the Stellar Network applies an operation. This code is helpful for understanding failed transactions.stringhistory_operations
operation_trace_codeThe trace code returned when an operation is applied to the Stellar Network. This code is helpful for understanding failure types.stringhistory_operations