Skip to content
Permalink
master
Switch branches/tags

new-docs/content/api/resources/operations/object/buy-offer.mdx

Go to file
 
 
Cannot retrieve contributors at this time
100 lines (91 sloc) 3.12 KB
Raw Blame
Open in GitHub Desktop
title order
Manage Buy Offer Object
60

import { ExampleResponse } from "components/ExampleResponse"; import { AttributeTable } from "components/AttributeTable";

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.

  • ATTRIBUTE
    • DATA TYPE
    • DESCRIPTION
  • amount
    • string
    • The amount of buying_asset that the account making this offer is willing to buy.
  • price
    • string
    • 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_r
    • object
    • A precise representation of the buy and sell price of the assets on offer.
      • n
        • number
        • The numerator.
      • d
        • number
        • The denominator.
  • buying_asset_type
    • string
    • The type for the buying asset. Either native, credit_alphanum4, or credit_alphanum12.
  • buying_asset_issuer
    • string
    • The Stellar address of the buying asset’s issuer. Appears if the buying_asset_type is not native.
  • buying_asset_code
    • string
    • The code for the buying asset. Appears if the buying_asset_type is not native.
  • selling_asset_type
    • string
    • The type for the selling asset. Either native, credit_alphanum4, or credit_alphanum12.
  • selling_asset_issuer
    • string
    • The Stellar address of the selling asset’s issuer. Appears if the selling_asset_type is not native.
  • selling_asset_code
    • string
    • The code for the selling asset. Appears if the selling_asset_type is not native.
  • offer_id
    • string
    • A unique identifier for this offer.
{
  "_links": {
    "self": {
      "href": "https://horizon.stellar.org/operations/124893981065674756"
    },
    "transaction": {
      "href": "https://horizon.stellar.org/transactions/3b41ec1411ed67ed47c96c34067c9fcfadf6e7cc013effa0b10f3df5ed758ffc"
    },
    "effects": {
      "href": "https://horizon.stellar.org/operations/124893981065674756/effects"
    },
    "succeeds": {
      "href": "https://horizon.stellar.org/effects?order=desc\u0026cursor=124893981065674756"
    },
    "precedes": {
      "href": "https://horizon.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"
}