Retrieve an Offer

GET 
/offers/:offer_id

The single offer endpoint provides information on a specific offer.

Request

Path Parameters

offer_id anyrequired

A unique identifier for this offer.

Responses

200

Success

application/json

Schema

Schema

_links object
self object
href linkrequired
templated boolean
next object
href linkrequired
templated boolean
prev object
href linkrequired
templated boolean
_embedded object
records object[]
Array [
_links object
self objectrequired
href linkrequired
templated boolean
offer_maker objectrequired
href linkrequired
templated boolean
id id (string)required
paging_token stringrequired
seller address (string)required
Possible values: Value must match regular expression G[A-Z0-9]{55}
selling objectrequired
asset_type stringrequired
asset_code string
asset_issuer string
buying objectrequired
asset_type stringrequired
asset_code string
asset_issuer string
amount stringrequired
price_r objectrequired
n int32
d int32
price stringrequired
last_modified_ledger uint32required
last_modified_time stringrequired
sponser string
]

Example (from schema)

{
  "_links": {
    "self": {
      "href": "string",
      "templated": true
    },
    "next": {
      "href": "string",
      "templated": true
    },
    "prev": {
      "href": "string",
      "templated": true
    }
  },
  "_embedded": {
    "records": [
      {
        "_links": {
          "self": {
            "href": "string",
            "templated": true
          },
          "offer_maker": {
            "href": "string",
            "templated": true
          }
        },
        "id": "string",
        "paging_token": "string",
        "seller": "string",
        "selling": {
          "asset_type": "string",
          "asset_code": "string",
          "asset_issuer": "string"
        },
        "buying": {
          "asset_type": "string",
          "asset_code": "string",
          "asset_issuer": "string"
        },
        "amount": "string",
        "price_r": {
          "n": 0,
          "d": 0
        },
        "price": "string",
        "last_modified_ledger": 0,
        "last_modified_time": "string",
        "sponser": "string"
      }
    ]
  }
}

GetOfferByOfferId

{
  "_links": {
    "self": {
      "href": "https://horizon-testnet.stellar.org/offers/165563085"
    },
    "offer_maker": {
      "href": "https://horizon-testnet.stellar.org/accounts/GCM4PT6XDZBWOOENDS6FOU22GJQLJPV2GC7VRVII4TFGZBA3ZXNM55SV"
    }
  },
  "id": 165563085,
  "paging_token": "165563085",
  "seller": "GCM4PT6XDZBWOOENDS6FOU22GJQLJPV2GC7VRVII4TFGZBA3ZXNM55SV",
  "selling": {
    "asset_type": "credit_alphanum4",
    "asset_code": "USD",
    "asset_issuer": "GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX"
  },
  "buying": {
    "asset_type": "native"
  },
  "amount": "26.1075388",
  "price_r": {
    "n": 1449156725,
    "d": 84642346
  },
  "price": "17.1209423",
  "last_modified_ledger": 28412042,
  "last_modified_time": null
}

Loading...