Offers

Get a list of offers

Get list of offers

GEThttps://api.sandbox.horizonland.app/v1/offers

Query parameters

Response

Body

cursor*string

Generated cursor returned by previous query

remaining*integer

Remaining results flag. 1: there are remaining results matching this query, 0: no remaining results

result*array of OfferDetail (object)

Offer matching query parameters

Request

const response = await fetch('https://api.sandbox.horizonland.app/v1/offers', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "cursor": "text",
  "result": [
    {
      "assets": {
        "cursor": "text",
        "result": [
          {
            "collection": {
              "image_url": "text",
              "name": "text",
              "contract_address": "text"
            },
            "created_at": "text",
            "description": "text",
            "fees": [
              {
                "address": "text",
                "basis_points": 0,
                "type": "text"
              }
            ],
            "id": "text",
            "image_url": "text",
            "animation_url": "text",
            "external_link": "text",
            "name": "text",
            "listing": {
              "closing_date": "text",
              "fees": [
                {
                  "address": "text",
                  "basis_points": 0,
                  "type": "text"
                }
              ],
              "accept_price": 0,
              "start_price": 0,
              "current_price": 0,
              "name": "text",
              "token_address": "text",
              "token_id": "text",
              "chain": {
                "id": "text",
                "name": "text",
                "symbol": "text"
              }
            },
            "status": "text",
            "token_address": "text",
            "token_id": "text",
            "chain": {
              "id": "text",
              "name": "text",
              "symbol": "text"
            },
            "updated_at": "text",
            "owner": "text"
          }
        ]
      },
      "taker": "text",
      "price": 0,
      "start_time": "text",
      "end_time": "text"
    }
  ]
}

Get detail of a offer

Get detail of an offer

GEThttps://api.sandbox.horizonland.app/v1/offers/{id}

Path parameters

id*string

ID of offer

Response

Body

assetsListAssetsResponse (object)

taker*string

Taker of this offer

price*number

Price of the asset

start_time*string

Start time of this offer

end_time*string

End time of this offer

Request

const response = await fetch('https://api.sandbox.horizonland.app/v1/offers/{id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "assets": {
    "cursor": "text",
    "result": [
      {
        "collection": {
          "image_url": "text",
          "name": "text",
          "contract_address": "text"
        },
        "created_at": "text",
        "description": "text",
        "fees": [
          {
            "address": "text",
            "basis_points": 0,
            "type": "text"
          }
        ],
        "id": "text",
        "image_url": "text",
        "animation_url": "text",
        "external_link": "text",
        "name": "text",
        "listing": {
          "closing_date": "text",
          "fees": [
            {
              "address": "text",
              "basis_points": 0,
              "type": "text"
            }
          ],
          "accept_price": 0,
          "start_price": 0,
          "current_price": 0,
          "name": "text",
          "token_address": "text",
          "token_id": "text",
          "chain": {
            "id": "text",
            "name": "text",
            "symbol": "text"
          }
        },
        "status": "text",
        "token_address": "text",
        "token_id": "text",
        "chain": {
          "id": "text",
          "name": "text",
          "symbol": "text"
        },
        "updated_at": "text",
        "owner": "text"
      }
    ]
  },
  "taker": "text",
  "price": 0,
  "start_time": "text",
  "end_time": "text"
}

Create an offer

POSThttps://api.sandbox.horizonland.app/v1/offers

Body

req

asset_id*string

Asset ID of the asset to be offered

price*number

Price of the asset

start_time*string

Start time of this offer

end_time*string

End time of this offer

Response

Headers

Body

assetsListAssetsResponse (object)

taker*string

Taker of this offer

price*number

Price of the asset

start_time*string

Start time of this offer

end_time*string

End time of this offer

Request

const response = await fetch('https://api.sandbox.horizonland.app/v1/offers', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "asset_id": "text",
      "price": 0,
      "start_time": "text",
      "end_time": "text"
    }),
});
const data = await response.json();

Response

{
  "assets": {
    "cursor": "text",
    "result": [
      {
        "collection": {
          "image_url": "text",
          "name": "text",
          "contract_address": "text"
        },
        "created_at": "text",
        "description": "text",
        "fees": [
          {
            "address": "text",
            "basis_points": 0,
            "type": "text"
          }
        ],
        "id": "text",
        "image_url": "text",
        "animation_url": "text",
        "external_link": "text",
        "name": "text",
        "listing": {
          "closing_date": "text",
          "fees": [
            {
              "address": "text",
              "basis_points": 0,
              "type": "text"
            }
          ],
          "accept_price": 0,
          "start_price": 0,
          "current_price": 0,
          "name": "text",
          "token_address": "text",
          "token_id": "text",
          "chain": {
            "id": "text",
            "name": "text",
            "symbol": "text"
          }
        },
        "status": "text",
        "token_address": "text",
        "token_id": "text",
        "chain": {
          "id": "text",
          "name": "text",
          "symbol": "text"
        },
        "updated_at": "text",
        "owner": "text"
      }
    ]
  },
  "taker": "text",
  "price": 0,
  "start_time": "text",
  "end_time": "text"
}

Accept an offer

POSThttps://api.sandbox.horizonland.app/v1/offers/accept

Body

req

asset_idstring

Offer ID of the offer to be accepted

Response

Headers

Body

offer*OfferDetail (object)

status*string

Status of the order

created_at*nullable string

Timestamp of when the order was created

updated_at*nullable string

Timestamp of when the order was last updated

Request

const response = await fetch('https://api.sandbox.horizonland.app/v1/offers/accept', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "offer": {
    "assets": {
      "cursor": "text",
      "result": [
        {
          "collection": {
            "image_url": "text",
            "name": "text",
            "contract_address": "text"
          },
          "created_at": "text",
          "description": "text",
          "fees": [
            {
              "address": "text",
              "basis_points": 0,
              "type": "text"
            }
          ],
          "id": "text",
          "image_url": "text",
          "animation_url": "text",
          "external_link": "text",
          "name": "text",
          "listing": {
            "closing_date": "text",
            "fees": [
              {
                "address": "text",
                "basis_points": 0,
                "type": "text"
              }
            ],
            "accept_price": 0,
            "start_price": 0,
            "current_price": 0,
            "name": "text",
            "token_address": "text",
            "token_id": "text",
            "chain": {
              "id": "text",
              "name": "text",
              "symbol": "text"
            }
          },
          "status": "text",
          "token_address": "text",
          "token_id": "text",
          "chain": {
            "id": "text",
            "name": "text",
            "symbol": "text"
          },
          "updated_at": "text",
          "owner": "text"
        }
      ]
    },
    "taker": "text",
    "price": 0,
    "start_time": "text",
    "end_time": "text"
  },
  "status": "text",
  "created_at": "text",
  "updated_at": "text"
}

PreviousOrders NextEvents

Last updated 1 year ago

{ "cursor": "text", "result": [ { "assets": { "cursor": "text", "result": [ { "collection": { "image_url": "text", "name": "text", "contract_address": "text" }, "created_at": "text", "description": "text", "fees": [ { "address": "text", "basis_points": 0, "type": "text" } ], "id": "text", "image_url": "text", "animation_url": "text", "external_link": "text", "name": "text", "listing": { "closing_date": "text", "fees": [ { "address": "text", "basis_points": 0, "type": "text" } ], "accept_price": 0, "start_price": 0, "current_price": 0, "name": "text", "token_address": "text", "token_id": "text", "chain": { "id": "text", "name": "text", "symbol": "text" } }, "status": "text", "token_address": "text", "token_id": "text", "chain": { "id": "text", "name": "text", "symbol": "text" }, "updated_at": "text", "owner": "text" } ] }, "taker": "text", "price": 0, "start_time": "text", "end_time": "text" } ] }

const response = await fetch('https://api.sandbox.horizonland.app/v1/offers', { method: 'POST', headers: { "Content-Type": "application/json" }, body: JSON.stringify({ "asset_id": "text", "price": 0, "start_time": "text", "end_time": "text" }), }); const data = await response.json();

{ "assets": { "cursor": "text", "result": [ { "collection": { "image_url": "text", "name": "text", "contract_address": "text" }, "created_at": "text", "description": "text", "fees": [ { "address": "text", "basis_points": 0, "type": "text" } ], "id": "text", "image_url": "text", "animation_url": "text", "external_link": "text", "name": "text", "listing": { "closing_date": "text", "fees": [ { "address": "text", "basis_points": 0, "type": "text" } ], "accept_price": 0, "start_price": 0, "current_price": 0, "name": "text", "token_address": "text", "token_id": "text", "chain": { "id": "text", "name": "text", "symbol": "text" } }, "status": "text", "token_address": "text", "token_id": "text", "chain": { "id": "text", "name": "text", "symbol": "text" }, "updated_at": "text", "owner": "text" } ] }, "taker": "text", "price": 0, "start_time": "text", "end_time": "text" }

const response = await fetch('https://api.sandbox.horizonland.app/v1/offers/accept', { method: 'POST', headers: { "Content-Type": "application/json" }, body: JSON.stringify({}), }); const data = await response.json();

{ "offer": { "assets": { "cursor": "text", "result": [ { "collection": { "image_url": "text", "name": "text", "contract_address": "text" }, "created_at": "text", "description": "text", "fees": [ { "address": "text", "basis_points": 0, "type": "text" } ], "id": "text", "image_url": "text", "animation_url": "text", "external_link": "text", "name": "text", "listing": { "closing_date": "text", "fees": [ { "address": "text", "basis_points": 0, "type": "text" } ], "accept_price": 0, "start_price": 0, "current_price": 0, "name": "text", "token_address": "text", "token_id": "text", "chain": { "id": "text", "name": "text", "symbol": "text" } }, "status": "text", "token_address": "text", "token_id": "text", "chain": { "id": "text", "name": "text", "symbol": "text" }, "updated_at": "text", "owner": "text" } ] }, "taker": "text", "price": 0, "start_time": "text", "end_time": "text" }, "status": "text", "created_at": "text", "updated_at": "text" }