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

object

required

href linkrequired

templated boolean

offer_maker

object

required

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

object

required

asset_type stringrequired

asset_code string

asset_issuer string

buying

object

required

asset_type stringrequired

asset_code string

asset_issuer string

amount stringrequired

price_r

object

required

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