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.