Skip to content

Commit a306040

Browse files
JFWooten4ElliotFriend
authored andcommitted
💱 Start of execution chat
Some more here dependent on XDR and propogation implementations, which are good for future scopes per https://discord.com/channels/897514728459468821/907476473739354153/1273021348628664433
1 parent 1d8e302 commit a306040

File tree

2 files changed

+6
-4
lines changed

2 files changed

+6
-4
lines changed

docs/data/apis/horizon/api-reference/resources/operations/object/buy-offer.mdx

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,8 @@ import { AttributeTable } from "@site/src/components/AttributeTable";
88

99
Creates, updates, or deletes a buy offer to trade assets. A buy offer specifies a certain amount of the buying asset that should be sold in exchange for the minimum quantity of the selling asset.
1010

11+
If an entire buy offer isn't fulfilled by existing liquidity, the remaining order volume gets converted to a sell offer representation internally.
12+
1113
See the [`Manage Buy Offer` errors](../../../errors/result-codes/operation-specific/manage-buy-offer.mdx).
1214

1315
<AttributeTable>

docs/learn/fundamentals/liquidity-on-stellar-sdex-liquidity-pools.mdx

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -20,9 +20,11 @@ The simplest way to interact with the SDEX is to post a limit (or priced) order
2020

2121
If ypou've ever traded on any type of investment platform, the terminology here will be fairly familiar. You can use the [Manage Buy Offer](../../../data/horizon/api-reference/resources/operations/object/buy-offer.mdx) operation to specifcy exactly how much you want to purchase at a specific price. The protocol calculates the cost of the trade in terms of `amount * price` and locks up the `selling` asset you offer in exchange as collateral, until the trade is (partially) executed or cancelled.
2222

23-
one last pg on the sell offer and then let;s diving next
23+
Alternatively, you can specify exactly how much of an asset you want to seel at a specific price using the [Manage Sell Offer](../../../data/horizon/api-reference/resources/operations/object/sell-offer.mdx) operation. Orders are executed on a price-time priority, meaning validators first match orders based on price. For orders placed at the same price, the order that was received earlier is given priority and is executed before the newer one.
2424

25-
and [Manage Sell Offer](../../../data/horizon/api-reference/resources/operations/object/sell-offer.mdx) operations. The Stellar ledger stores both the balances held by user accounts and orders that user accounts make to trade assets. [Validators](https://stellarbeat.io) track exactly which price these orders will accept and the quantity avaliable to transact.
25+
## Free Market Data
26+
27+
The Stellar ledger stores both the balances held by user accounts and orders that user accounts make to trade assets. [Validators](https://stellarbeat.io) track exactly which price these orders will accept and the quantity avaliable to transact.
2628

2729
When you convert one currency to another in traditional financial markets, your trade happens because of limit orders. These orders specify how much someone will pay for a certain amount of any asset. Thus, when you need to convert your dollars to yen, e.g., their order to sell yen for dollars counteracts and "fulfills" your trade.
2830

@@ -636,8 +638,6 @@ Orders in Stellar behave like limit orders in traditional markets. When an accou
636638

637639
Each order constitutes a selling obligation for the selling asset and buying obligation for the buying asset. These obligations are stored in the account (for lumens) or trustline (for other assets) owned by the account creating the order. Any operation that would cause an account to be unable to satisfy its obligations (such as sending away too much balance) will fail. This guarantees that any order in the orderbook can be executed entirely.
638640

639-
Orders are executed on a price-time priority, meaning orders will be executed based first on price; for orders placed at the same price, the order that was entered earlier is given priority and is executed before the newer one.
640-
641641
#### Path Hops
642642

643643
When sending path payments, your transfer can hop between up to six order books or AMMs to find the best price. Validators perform this arithmatic automatically, allowing you to specify only the lowest total amount you will accept. At each step in the path, the network calculates the optimal source of liquidity to convert through given your destination asset.

0 commit comments

Comments
 (0)