Skip to main content

Manage Sell Offer Object

Creates, updates, or deletes a sell offer to trade assets. A sell offer specifies a certain amount of the selling asset that should be sold in exchange for the maximum quantity of the buying asset.

See the Manage Sell Offer errors.

  • ATTRIBUTEDATA TYPE

    DESCRIPTION

  • amountstring

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

  • pricestring

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

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

  • buying_asset_typestring

    The type for the buying asset. Either native, credit_alphanum4, or credit_alphanum12.

  • buying_asset_issuerstring

    The Stellar address of the buying asset’s issuer. Appears if the buying_asset_type is not native.

  • buying_asset_codestring

    The code for the buying asset. Appears if the buying_asset_type is not native.

  • selling_asset_typestring

    The type for the selling asset. Either native, credit_alphanum4, or credit_alphanum12.

  • selling_asset_issuerstring

    The Stellar address of the selling asset’s issuer. Appears if the selling_asset_type is not native.

  • selling_asset_codestring

    The code for the selling asset. Appears if the selling_asset_type is not native.

  • offer_idstring

    A unique identifier for this offer.

    • Example
    {
      "_links": {
        "self": {
          "href": "https://horizon-testnet.stellar.org/operations/124892722640347138"
        },
        "transaction": {
          "href": "https://horizon-testnet.stellar.org/transactions/ef8ffb54ff5990a686fda3ebfc07b8162f042ff0fcdb4f7ff141531e386f0a18"
        },
        "effects": {
          "href": "https://horizon-testnet.stellar.org/operations/124892722640347138/effects"
        },
        "succeeds": {
          "href": "https://horizon-testnet.stellar.org/effects?order=desc\u0026cursor=124892722640347138"
        },
        "precedes": {
          "href": "https://horizon-testnet.stellar.org/effects?order=asc\u0026cursor=124892722640347138"
        }
      },
      "id": "124892722640347138",
      "paging_token": "124892722640347138",
      "transaction_successful": true,
      "source_account": "GCM4PT6XDZBWOOENDS6FOU22GJQLJPV2GC7VRVII4TFGZBA3ZXNM55SV",
      "type": "manage_sell_offer",
      "type_i": 3,
      "created_at": "2020-04-08T13:36:39Z",
      "transaction_hash": "ef8ffb54ff5990a686fda3ebfc07b8162f042ff0fcdb4f7ff141531e386f0a18",
      "amount": "1336.0326986",
      "price": "0.0559999",
      "price_r": {
        "n": 559999,
        "d": 10000000
      },
      "buying_asset_type": "credit_alphanum4",
      "buying_asset_code": "USD",
      "buying_asset_issuer": "GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX",
      "selling_asset_type": "native",
      "offer_id": "0"
    }