Assets

Get a list of assets

Get list of assets

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

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 AssetDetail (object)

Assets matching query parameters

Request

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

Response

{
  "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"
    }
  ]
}

Get details of an asset

GEThttps://api.sandbox.horizonland.app/v1/assets/{token_address}/{token_id}

Path parameters

token_address*string

Address of the ERC721 contract

token_id*string

Either ERC721 token ID

Response

Body

collection*CollectionSummary (object)

created_at*nullable string

Timestamp of when the asset was created

description*nullable string

Description of this asset

feesarray of Fee (object)

Fee structure for this asset

idstring

Asset ID

image_url*nullable string

URL of the image which should be used for this asset

animation_url*nullable string

URL of the animation which should be used for this asset

external_link*nullable string

URL of the external link which should be used for this asset

metadata*nullable object

Metadata of this asset

name*nullable string

Name of this asset

listingListingDetail (object)

status*string

Status of this asset (where it is in the system)

token_address*string

Address of the ERC721 contract

token_id*string

ERC721 Token ID of this asset

chain*ChainDetail (object)

updated_at*nullable string

Timestamp of when the asset was updated

owner*string

Address of the user who owns this asset

Request

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

Response

{
  "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"
}

Create an asset

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

Body

req

collection_id*string

Collection ID

description*string

Description of this asset

image_url*string

URL of the image which should be used for this asset

animation_urlstring

URL of the animation which should be used for this asset

external_linkstring

URL of the external link which should be used for this asset

metadata*object

Metadata of this asset

name*string

Name of this asset

token_address*string

Address of the ERC721 contract

chain_id*string

Chain ID of the asset

owner*string

Address of the user who owns this asset

Response

Headers

Body

collection*CollectionSummary (object)

created_at*nullable string

Timestamp of when the asset was created

description*nullable string

Description of this asset

feesarray of Fee (object)

Fee structure for this asset

idstring

Asset ID

image_url*nullable string

URL of the image which should be used for this asset

animation_url*nullable string

URL of the animation which should be used for this asset

external_link*nullable string

URL of the external link which should be used for this asset

metadata*nullable object

Metadata of this asset

name*nullable string

Name of this asset

listingListingDetail (object)

status*string

Status of this asset (where it is in the system)

token_address*string

Address of the ERC721 contract

token_id*string

ERC721 Token ID of this asset

chain*ChainDetail (object)

updated_at*nullable string

Timestamp of when the asset was updated

owner*string

Address of the user who owns this asset

Request

const response = await fetch('https://api.sandbox.horizonland.app/v1/assets', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "collection_id": "text",
      "description": "text",
      "image_url": "text",
      "name": "text",
      "token_address": "text",
      "chain_id": "text",
      "owner": "text"
    }),
});
const data = await response.json();

Response

{
  "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"
}

Import CSV to create asset

Import assets from a CSV file

Create an asset

POSThttps://api.sandbox.horizonland.app/v1/assets/import

Body

file*string (binary)

collection_id*string

Response

Headers

Body

dataobject

The success details

message*string

The success message

Request

const response = await fetch('https://api.sandbox.horizonland.app/v1/assets/import', {
    method: 'POST',
    headers: {
      "Content-Type": "multipart/form-data"
    },
    body: JSON.stringify({
      "file": "binary",
      "collection_id": "text"
    }),
});
const data = await response.json();

Response

{
  "message": "text"
}

Asset listing

Add an asset to the marketplace

POSThttps://api.sandbox.horizonland.app/v1/assets/listing

Body

req

listing_timestring

Time of asset be listed

expiration_timeobject

Expiration of asset be listed

maker_feesobject

Maker fees

order_typestring

Order type

accept_pricenumber

Accept price

start_pricenumber

Start price

current_pricenumber

Current price

signaturestring

Maker signature

Response

Headers

Body

closing_date*nullable string

Closing date of the listing

fees*array of Fee (object)

Fee structure for this asset

accept_price*number

Accept price of the listing

start_price*number

Start price of the listing

current_price*number

Current price of the listing

name*string

Name of the asset

token_address*string

Token address of the asset

token_id*string

Token ID of the asset

chain*ChainDetail (object)

Request

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

Response

{
  "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"
  }
}

Update an asset listing

PUThttps://api.sandbox.horizonland.app/v1/assets/listing/{token_address}/{token_id}

Path parameters

token_address*string

Address of the ERC721 contract

token_id*string

Either ERC721 token ID

Body

req

listing_timestring

Time of asset be listed

expiration_timeobject

Expiration of asset be listed

accept_pricenumber

Accept price

start_pricenumber

Start price

Response

Headers

Body

closing_date*nullable string

Closing date of the listing

fees*array of Fee (object)

Fee structure for this asset

accept_price*number

Accept price of the listing

start_price*number

Start price of the listing

current_price*number

Current price of the listing

name*string

Name of the asset

token_address*string

Token address of the asset

token_id*string

Token ID of the asset

chain*ChainDetail (object)

Request

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

Response

{
  "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"
  }
}

PreviousAPI Reference NextCollections

Last updated 1 year ago

{ "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" }

const response = await fetch('https://api.sandbox.horizonland.app/v1/assets', { method: 'POST', headers: { "Content-Type": "application/json" }, body: JSON.stringify({ "collection_id": "text", "description": "text", "image_url": "text", "name": "text", "token_address": "text", "chain_id": "text", "owner": "text" }), }); const data = await response.json();