Skip to main content

Manage Buy Offer Object

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

See the Manage Buy Offer errors.

  • ATTRIBUTEDATA TYPE

    DESCRIPTION

  • amountstring

    The amount of buying_asset that the account making this offer is willing to buy.

  • pricestring

    How many units of buying_asset it takes to get 1 unit of selling_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/124893981065674756"
        },
        "transaction": {
          "href": "https://horizon-testnet.stellar.org/transactions/3b41ec1411ed67ed47c96c34067c9fcfadf6e7cc013effa0b10f3df5ed758ffc"
        },
        "effects": {
          "href": "https://horizon-testnet.stellar.org/operations/124893981065674756/effects"
        },
        "succeeds": {
          "href": "https://horizon-testnet.stellar.org/effects?order=desc\u0026cursor=124893981065674756"
        },
        "precedes": {
          "href": "https://horizon-testnet.stellar.org/effects?order=asc\u0026cursor=124893981065674756"
        }
      },
      "id": "124893981065674756",
      "paging_token": "124893981065674756",
      "transaction_successful": true,
      "source_account": "GDT7WYNV6YBFJH3G6TX5K3ALBZY7A7A7CLIGXK4XZ6H5SROPS4UFGEMC",
      "type": "manage_buy_offer",
      "type_i": 12,
      "created_at": "2020-04-08T14:03:03Z",
      "transaction_hash": "3b41ec1411ed67ed47c96c34067c9fcfadf6e7cc013effa0b10f3df5ed758ffc",
      "amount": "20.4521401",
      "price": "0.0300003",
      "price_r": {
        "n": 9000190,
        "d": 300003333
      },
      "buying_asset_type": "native",
      "selling_asset_type": "credit_alphanum4",
      "selling_asset_code": "EURT",
      "selling_asset_issuer": "GAP5LETOV6YIE62YAM56STDANPRDO7ZFDBGSNHJQIYGGKSMOZAHOOS2S",
      "offer_id": "0"
    }