Skip to main content

Offers

Table Metadata

PropertyConfiguration
Natural Key(s)offer_id, closed_at
Partition Field(s)batch_run_date (MONTH partition)
Clustered Field(s)selling_asset_id, buying_asset_id, last_modified_ledger
Documentationdbt docs

Column Details

NameDescriptionData TypeDomain ValuesRequired?Notes
seller_idThe account address that is making this offerstringYes
offer_idThe unique identifier for this offerintegerYes
selling_asset_typeThe identifier for type of asset code, can be an alphanumeric with 4 characters, 12 characters or the native asset to the network, XLM.string
  • credit_alphanum4
  • credit_alphanum12
  • native
Yes
selling_asset_codeThe 4 or 12 character code representation of the asset offered to be soldstringNo
selling_asset_issuerThe account address of the original asset issuer that minted the asset which will be sold in exchange for another assetstringNo
buying_asset_typeThe identifier for type of asset code, can be an alphanumeric with 4 characters, 12 characters or the native asset to the network, XLM.string
  • credit_alphanum4
  • credit_alphanum12
  • native
Yes
buying_asset_codeThe 4 or 12 character code representation of the asset desired to be purchasedstringNo
buying_asset_issuerThe account address of the original asset issuer that minted the asset which will be bought in exchange for a currently held assetstringNo
amountThe amount of selling that the account making this offer is willing to sellfloatYes
pricenThe numerator of the precise representation of the buy and sell price of assets on offer (The buy amount desired)integerYesIf an offer wants to sell 10 XLM in exchange for 1 USD, the numerator will be 1.
pricedThe denominator of the precise representation of the buy and sell price of assets on offer (The sell amount offered)integerYesIf an offer wants to sell 10 XLM in exchange for 1 USD, the denominator will be 10.
priceHow many units of buying it takes to get 1 unit of selling. This number is the decimal form of pricen / pricedfloatYesIf an offer wants to sell 10 XLM in exchange for 1 USD, the price will be 0.1
flagsDenotes the enabling/disabling of certain asset issuer privilegesinteger
  • 0 - None, Default
  • 1 - Passive (offer with this flag will not act on and take a reverse offer of equal price)
Yes
last_modified_ledgerThe ledger sequence number when the ledger entry (this unique signer for the account) was modified. Deletions do not count as a modification and will report the prior modification sequence numberintegerYes
ledger_entry_changeCode that describes the ledger entry change type that was applied to the ledger entry.integer
  • 0 - Ledger Entry Created
  • 1 - Ledger Entry Updated
  • 2 - Ledger Entry Deleted
  • 3 - Ledger Entry State (value of the entry)
YesValid entry change types are 0, 1, and 2 for ledger entries of type offers.
deletedIndicates whether the ledger entry (offer id) has been deleted or not. Once an entry is deleted, it cannot be recoveredbooleanYes
closed_atTimestamp in UTC when this ledger closed and committed to the network. Ledgers are expected to close ~every 5 secondstimestampYes
ledger_sequenceThe sequence number of this ledger. It represents the order of the ledger within the Stellar blockchain. Each ledger has a unique sequence number that increments with every new ledger, ensuring that ledgers are processed in the correct order.integerYes
sponsorThe account address that is sponsoring the base reserves for the offerstringNo
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 capabilitiesstringYes
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.datetimeYesThe 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 backfilltimestampYes
selling_asset_idUnique identifier for selling_asset_code, selling_asset_issuerintegerNo
buying_asset_idUnique identifier for buying_asset_code, buying_asset_issuerintegerNo