Assets

PreviousAPI Reference NextCollections

Last updated 2 years ago

Get list of assets

get

Get list of assets

Query parameters

asset_contractanyOptional

Asset Contract

collection_idanyOptional

Collection ID

owner_idanyOptional

Owner ID

statusanyOptional

Status of these asset

limitanyOptional

Limit

pageanyOptional

Current page number

order_byanyOptional

Property to sort by

directionanyOptional

Direction to sort

Responses

application/json

objectOptional

application/json

get

GET /v1/assets HTTP/1.1
Host: api.sandbox.horizonland.app
Accept: */*

{
  "cursor": "text",
  "remaining": 1,
  "result": [
    {
      "collection": {
        "image_url": "text",
        "name": "text",
        "contract_address": "text"
      },
      "created_at": "text",
      "description": "text",
      "fees": [
        {
          "address": "text",
          "basis_points": 1,
          "type": "text"
        }
      ],
      "id": "text",
      "image_url": "text",
      "animation_url": "text",
      "external_link": "text",
      "metadata": {},
      "name": "text",
      "listing": {
        "closing_date": "text",
        "fees": [
          {
            "address": "text",
            "basis_points": 1,
            "type": "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"
        }
      },
      "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

get

Get details of an asset

Path parameters

token_addressanyRequired

Address of the ERC721 contract

token_idanyRequired

Either ERC721 token ID

Responses

application/json

objectOptional

application/json

get

GET /v1/assets/{token_address}/{token_id} HTTP/1.1
Host: api.sandbox.horizonland.app
Accept: */*

{
  "collection": {
    "image_url": "text",
    "name": "text",
    "contract_address": "text"
  },
  "created_at": "text",
  "description": "text",
  "fees": [
    {
      "address": "text",
      "basis_points": 1,
      "type": "text"
    }
  ],
  "id": "text",
  "image_url": "text",
  "animation_url": "text",
  "external_link": "text",
  "metadata": {},
  "name": "text",
  "listing": {
    "closing_date": "text",
    "fees": [
      {
        "address": "text",
        "basis_points": 1,
        "type": "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"
    }
  },
  "status": "text",
  "token_address": "text",
  "token_id": "text",
  "chain": {
    "id": "text",
    "name": "text",
    "symbol": "text"
  },
  "updated_at": "text",
  "owner": "text"
}

Create an asset

post

Create an asset

Body

collection_idstringRequired

Collection ID

descriptionstringRequired

Description of this asset

image_urlstringRequired

URL of the image which should be used for this asset

animation_urlstringOptional

URL of the animation which should be used for this asset

external_linkstringOptional

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

objectOptional

application/json

post

POST /v1/assets HTTP/1.1
Host: api.sandbox.horizonland.app
Content-Type: application/json
Accept: */*
Content-Length: 194

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

{
  "collection": {
    "image_url": "text",
    "name": "text",
    "contract_address": "text"
  },
  "created_at": "text",
  "description": "text",
  "fees": [
    {
      "address": "text",
      "basis_points": 1,
      "type": "text"
    }
  ],
  "id": "text",
  "image_url": "text",
  "animation_url": "text",
  "external_link": "text",
  "metadata": {},
  "name": "text",
  "listing": {
    "closing_date": "text",
    "fees": [
      {
        "address": "text",
        "basis_points": 1,
        "type": "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"
    }
  },
  "status": "text",
  "token_address": "text",
  "token_id": "text",
  "chain": {
    "id": "text",
    "name": "text",
    "symbol": "text"
  },
  "updated_at": "text",
  "owner": "text"
}

Import assets from a CSV file

post

Create an asset

Body

filefileRequired

collection_idstringRequired

Responses

application/json

objectOptional

application/json

post

POST /v1/assets/import HTTP/1.1
Host: api.sandbox.horizonland.app
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 36

"file=null&collection_id='text'"

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

Add an asset to the marketplace

post

Add an asset to the marketplace

Body

listing_timestringOptional

Time of asset be listed

expiration_timeobjectOptional

Expiration of asset be listed

maker_feesobjectOptional

Maker fees

order_typestringOptional

Order type

accept_pricenumberOptional

Accept price

start_pricenumberOptional

Start price

current_pricenumberOptional

Current price

signaturestringOptional

Maker signature

Responses

application/json

objectOptional

application/json

post

POST /v1/assets/listing HTTP/1.1
Host: api.sandbox.horizonland.app
Content-Type: application/json
Accept: */*
Content-Length: 150

{
  "listing_time": "text",
  "expiration_time": {},
  "maker_fees": {},
  "order_type": "text",
  "accept_price": 1,
  "start_price": 1,
  "current_price": 1,
  "signature": "text"
}

{
  "closing_date": "text",
  "fees": [
    {
      "address": "text",
      "basis_points": 1,
      "type": "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"
  }
}

Update an asset listing

put

Update an asset listing

Path parameters

token_addressanyRequired

Address of the ERC721 contract

token_idanyRequired

Either ERC721 token ID

Body

listing_timestringOptional

Time of asset be listed

expiration_timeobjectOptional

Expiration of asset be listed

accept_pricenumberOptional

Accept price

start_pricenumberOptional

Start price

Responses

application/json

objectOptional

application/json

put

PUT /v1/assets/listing/{token_address}/{token_id} HTTP/1.1
Host: api.sandbox.horizonland.app
Content-Type: application/json
Accept: */*
Content-Length: 77

{
  "listing_time": "text",
  "expiration_time": {},
  "accept_price": 1,
  "start_price": 1
}

{
  "closing_date": "text",
  "fees": [
    {
      "address": "text",
      "basis_points": 1,
      "type": "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"
  }
}

Assets

Assets

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