Assets

Get list of assets

get

/assets

Query parameters

asset_contractany

Asset Contract

collection_idany

Collection ID

owner_idany

Owner ID

statusany

Status of these asset

limitany

Limit

pageany

Current page number

order_byany

Property to sort by

directionany

Direction to sort

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.sandbox.horizonland.app/v1/assets'

200

400

500

{
  "cursor": "text",
  "remaining": 1,
  "result": [
    {
      "collection": {
        "image_url": "text",
        "name": "text",
        "contract_address": "text"
      },
      "created_at": "text",
      "description": "text",
      "id": "text",
      "image_url": "text",
      "animation_url": "text",
      "external_link": "text",
      "metadata": {},
      "name": "text",
      "listing": {
        "closing_date": "text",
        "accept_price": 1,
        "start_price": 1,
        "current_price": 1,
        "name": "text",
        "token_address": "text",
        "token_id": "text",
        "chain": {
          "id": "text",
          "name": "text",
          "symbol": "text"
        },
        "fees": [
          {
            "address": "text",
            "basis_points": 1,
            "type": "text"
          }
        ]
      },
      "status": "text",
      "token_address": "text",
      "token_id": "text",
      "chain": {
        "id": "text",
        "name": "text",
        "symbol": "text"
      },
      "updated_at": "text",
      "owner": "text",
      "fees": [
        {
          "address": "text",
          "basis_points": 1,
          "type": "text"
        }
      ]
    }
  ]
}

Get details of an asset

get

/assets/{token_address}//{token_id}

Path parameters

token_addressanyrequired

Address of the ERC721 contract

token_idanyrequired

Either ERC721 token ID

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.sandbox.horizonland.app/v1/assets/{token_address}/{token_id}'

200

404

500

{
  "collection": {
    "image_url": "text",
    "name": "text",
    "contract_address": "text"
  },
  "created_at": "text",
  "description": "text",
  "id": "text",
  "image_url": "text",
  "animation_url": "text",
  "external_link": "text",
  "metadata": {},
  "name": "text",
  "listing": {
    "closing_date": "text",
    "accept_price": 1,
    "start_price": 1,
    "current_price": 1,
    "name": "text",
    "token_address": "text",
    "token_id": "text",
    "chain": {
      "id": "text",
      "name": "text",
      "symbol": "text"
    },
    "fees": [
      {
        "address": "text",
        "basis_points": 1,
        "type": "text"
      }
    ]
  },
  "status": "text",
  "token_address": "text",
  "token_id": "text",
  "chain": {
    "id": "text",
    "name": "text",
    "symbol": "text"
  },
  "updated_at": "text",
  "owner": "text",
  "fees": [
    {
      "address": "text",
      "basis_points": 1,
      "type": "text"
    }
  ]
}

Create an asset

post

/assets

Body

collection_idstringrequired

Collection ID

descriptionstringrequired

Description of this asset

image_urlstringrequired

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

metadataobjectrequired

Metadata of this asset

namestringrequired

Name of this asset

token_addressstringrequired

Address of the ERC721 contract

chain_idstringrequired

Chain ID of the asset

ownerstringrequired

Address of the user who owns this asset

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://api.sandbox.horizonland.app/v1/assets' \
  --header 'Content-Type: application/json' \
  --data '{
    "collection_id": "text",
    "description": "text",
    "image_url": "text",
    "animation_url": "text",
    "external_link": "text",
    "metadata": {},
    "name": "text",
    "token_address": "text",
    "chain_id": "text",
    "owner": "text"
  }'

200

400

401

403

500

{
  "collection": {
    "image_url": "text",
    "name": "text",
    "contract_address": "text"
  },
  "created_at": "text",
  "description": "text",
  "id": "text",
  "image_url": "text",
  "animation_url": "text",
  "external_link": "text",
  "metadata": {},
  "name": "text",
  "listing": {
    "closing_date": "text",
    "accept_price": 1,
    "start_price": 1,
    "current_price": 1,
    "name": "text",
    "token_address": "text",
    "token_id": "text",
    "chain": {
      "id": "text",
      "name": "text",
      "symbol": "text"
    },
    "fees": [
      {
        "address": "text",
        "basis_points": 1,
        "type": "text"
      }
    ]
  },
  "status": "text",
  "token_address": "text",
  "token_id": "text",
  "chain": {
    "id": "text",
    "name": "text",
    "symbol": "text"
  },
  "updated_at": "text",
  "owner": "text",
  "fees": [
    {
      "address": "text",
      "basis_points": 1,
      "type": "text"
    }
  ]
}

Import assets from a CSV file

Create an asset

post

/assets/import

Body

filefilerequired

collection_idstringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://api.sandbox.horizonland.app/v1/assets/import' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data 'file=null&collection_id=text'

200

400

401

403

500

{
  "data": {},
  "message": "text"
}

Add an asset to the marketplace

post

/assets/listing

Body

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

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://api.sandbox.horizonland.app/v1/assets/listing' \
  --header 'Content-Type: application/json' \
  --data '{
    "listing_time": "text",
    "expiration_time": {},
    "maker_fees": {},
    "order_type": "text",
    "accept_price": 1,
    "start_price": 1,
    "current_price": 1,
    "signature": "text"
  }'

200

400

401

403

500

{
  "closing_date": "text",
  "accept_price": 1,
  "start_price": 1,
  "current_price": 1,
  "name": "text",
  "token_address": "text",
  "token_id": "text",
  "chain": {
    "id": "text",
    "name": "text",
    "symbol": "text"
  },
  "fees": [
    {
      "address": "text",
      "basis_points": 1,
      "type": "text"
    }
  ]
}

Update an asset listing

put

/assets/listing/{token_address}//{token_id}

Path parameters

token_addressanyrequired

Address of the ERC721 contract

token_idanyrequired

Either ERC721 token ID

Body

listing_timestring

Time of asset be listed

expiration_timeobject

Expiration of asset be listed

accept_pricenumber

Accept price

start_pricenumber

Start price

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request PUT \
  --url 'https://api.sandbox.horizonland.app/v1/assets/listing/{token_address}/{token_id}' \
  --header 'Content-Type: application/json' \
  --data '{
    "listing_time": "text",
    "expiration_time": {},
    "accept_price": 1,
    "start_price": 1
  }'

200

400

401

403

500

{
  "closing_date": "text",
  "accept_price": 1,
  "start_price": 1,
  "current_price": 1,
  "name": "text",
  "token_address": "text",
  "token_id": "text",
  "chain": {
    "id": "text",
    "name": "text",
    "symbol": "text"
  },
  "fees": [
    {
      "address": "text",
      "basis_points": 1,
      "type": "text"
    }
  ]
}

Get a list of assets

Get details of an asset

Create an asset

Import CSV to create asset

Asset listing

Update an asset listing

Get a list of assets

Get details of an asset

Create an asset

Import CSV to create asset

Asset listing

Update an asset listing

Get list of assets

Get details of an asset

Create an asset

Import assets from a CSV file

Add an asset to the marketplace

Update an asset listing