Accounts on the Stellar network can make offers to buy or sell assets. Users can create offers with the Manage Offer operation.
Horizon only returns offers that belong to a particular account. When it does, it uses the following format:
Attributes
| Attribute |
Type |
|
| id |
integer |
The ID of this offer. |
| paging_token |
string |
A paging token suitable for use as a cursor parameter. |
| seller |
string |
Account id of the account making this offer. |
| selling |
Asset |
The Asset this offer wants to sell. |
| buying |
Asset |
The Asset this offer wants to buy. |
| amount |
string |
The amount of selling the account making this offer is willing to sell. |
| price_r |
object |
An object of a number numerator and number denominator that represent the buy and sell price of the currencies on offer. |
| price |
string |
How many units of buying it takes to get 1 unit of selling. A number representing the decimal form of price_r. |
| last_modified_ledger |
integer |
sequence number for the latest ledger in which this offer was modified. |
| last_modified_time |
string |
An ISO 8601 formatted string of last modification time. |
Price_r Object
Price_r is a more precise representation of a bid/ask offer.
| Attribute |
Type |
|
| n |
number |
The numerator. |
| d |
number |
The denominator. |
Thus to get price you would take n / d.
Links
| rel |
Example |
Description |
templated |
| seller |
/accounts/{seller}?cursor,limit,order} |
Link to details about the account that made this offer. |
true |
Endpoints
| Resource |
Type |
Resource URI Template |
| Account Offers |
Collection |
/accounts/:account_id/offers |
Edit this doc in GitHub