Skip to main content

The Offer Object

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



  • 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.

  • Example
    "_links": {
    "self": {
    "href": ""
    "offer_maker": {
    "href": ""
    "id": 165561423,
    "paging_token": "165561423",
    "selling": {
    "asset_type": "credit_alphanum4",
    "asset_code": "NGNT",
    "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"