The Offer Object

When Horizon returns information about an offer, it uses the following format:

ATTRIBUTEDATA TYPE

DESCRIPTION

idstring

A unique identifier for this offer.

paging_tokennumber

A cursor value for use in pagination.

sellerstring

The account ID of the account making this offer.

sellingasset code

The asset this offer wants to sell.

buyingasset code

The asset this offer wants to buy.

amountstring

The amount of selling that the account making this offer is willing to sell.

price_robject

A precise representation of the buy and sell price of the assets on offer.

Show child attributes

nnumber

The numerator.

dnumber

The denominator.

pricestring

How many units of buying it takes to get 1 unit of selling. A number representing the decimal form of price_r.

last_modified_ledgerinteger

The sequence number of the last ledger in which this offer was modified.

last_modified_timestring

An ISO 8601 formatted string of last modification time.

sponsorstring (optional)

The account id of the sponsor who is paying the reserves for this offer.

The latest ledger known to Horizon is included as an HTTP header in the response.

Example

{
  "_links": {
    "self": {
      "href": "https://horizon-testnet.stellar.org/offers/165561423"
    },
    "offer_maker": {
      "href": "https://horizon-testnet.stellar.org/accounts/GCK4WSNF3F6ZNCMK6BU77ZCZ3NMF3JGU2U3ZAPKXYBKYYCJA72FDBY7K"
    }
  },
  "id": 165561423,
  "paging_token": "165561423",
  "seller": "GCK4WSNF3F6ZNCMK6BU77ZCZ3NMF3JGU2U3ZAPKXYBKYYCJA72FDBY7K",
  "selling": {
    "asset_type": "credit_alphanum4",
    "asset_code": "NGNT",
    "asset_issuer": "GAWODAROMJ33V5YDFY3NPYTHVYQG7MJXVJ2ND3AOGIHYRWINES6ACCPD"
  },
  "buying": {
    "asset_type": "native"
  },
  "amount": "18421.4486092",
  "price_r": {
    "n": 45112058,
    "d": 941460545
  },
  "price": "0.0479171",
  "last_modified_ledger": 28411995,
  "last_modified_time": "2020-02-26T19:29:16Z"
}