Skip to main content

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.

  • 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"
    }