Skip to main content

Offers

NameDescriptionData TypeDomain ValuesPrimary Key?Natural Key?Partition or Cluster Field?Required?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 a alphanumeric with 4 characters, 12 characters or the native asset to the network, XLM.stringcredit_alphanum4 credit_alphanum12 nativeYes
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 asset.stringNo
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 nativeYes
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 privilegesinteger0 - 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 numberintegerYesclusterYes
ledger_entry_changeCode that describes the ledger entry change type that was applied to the ledger entry.integer0 - Ledger Entry Created 1 - Ledger Entry Updated 2 - Ledger Entry Deleted 3 - Ledger Entry State (value of the entry)YesYesValid 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 recovered.booleanYes
sponsorThe account address that is sponsoring the base reserves for the offer.stringNo
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.datetimeMONTH partitionYesThe 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_issuerintegerclusterNo
buying_asset_idUnique identifier for buying_asset_code, buying_asset_issuerintegerclusterNo