Collections

Get a list of collections

Get list of collections

Get list of collections

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

Query parameters

Response

200400500

OK

Body

application/json

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

Collections matching query parameters

Request

JavaScriptCurlPython

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

Response

200400500

{
  "cursor": "text",
  "remaining": 0,
  "result": [
    {
      "contract_address": "text",
      "owner": "text",
      "total_supply": 0,
      "category": {
        "category_id": "text",
        "category_name": "text"
      },
      "name": "text",
      "slug": "text",
      "image_url": "text",
      "discord_url": "text",
      "telegram_url": "text",
      "external_url": "text",
      "twitter_username": "text",
      "instagram_username": "text",
      "fees": [
        {
          "address": "text",
          "basis_points": 0,
          "type": "text"
        }
      ],
      "chain": {
        "id": "text",
        "name": "text",
        "symbol": "text"
      },
      "assets": {
        "cursor": "text",
        "remaining": 0,
        "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 detail of a collection

Get details of a collection at the given address

Get details of a collection at the given address

GEThttps://api.sandbox.horizonland.app/v1/collections/{address}

Path parameters

address*string

Collection contract address

Query parameters

Response

200404

OK

Body

application/json

contract_addressstring

Contract address of the collection

ownerstring

Owner of the collection

total_supplynumber

Total supply of the collection

categoryCategoryDetail (object)

namestring

Name of the collection

slugstring

Slug of the collection

descriptionobject

Desction of the collection

image_urlstring

Image URL of the collection

discord_urlstring

Discord URL of the collection

telegram_urlstring

Telegram URL of the collection

external_urlstring

External URL of the collection

twitter_usernamestring

Twitter username of the collection

instagram_usernamestring

Instagram username of the collection

feesarray of Fee (object)

Fee structure for all assets of this colletion

chainChainDetail (object)

assetsListAssetsResponse (object)

Request

JavaScriptCurlPython

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

Response

200404

{
  "contract_address": "text",
  "owner": "text",
  "total_supply": 0,
  "category": {
    "category_id": "text",
    "category_name": "text"
  },
  "name": "text",
  "slug": "text",
  "image_url": "text",
  "discord_url": "text",
  "telegram_url": "text",
  "external_url": "text",
  "twitter_username": "text",
  "instagram_username": "text",
  "fees": [
    {
      "address": "text",
      "basis_points": 0,
      "type": "text"
    }
  ],
  "chain": {
    "id": "text",
    "name": "text",
    "symbol": "text"
  },
  "assets": {
    "cursor": "text",
    "remaining": 0,
    "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"
      }
    ]
  }
}

Create a collection

Create a collection

Create a collection

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

Body

application/json

req

contract_addressstring

Contract address of the collection

total_supplynumber

Total supply of the collection

namestring

Name of the collection

descriptionobject

Desction of the collection

image_urlstring

Image URL of the collection

discord_urlstring

Discord URL of the collection

telegram_urlstring

Telegram URL of the collection

external_urlstring

External URL of the collection

twitter_usernamestring

Twitter username of the collection

instagram_usernamestring

Instagram username of the collection

feesarray of Fee (object)

Fee structure for all assets of this colletion

chain_idstring

Chain ID of all assets of this collection

category_idstring

Category ID of the collection

Response

200400401403500

OK

Headers

Body

application/json

contract_addressstring

Contract address of the collection

ownerstring

Owner of the collection

total_supplynumber

Total supply of the collection

categoryCategoryDetail (object)

namestring

Name of the collection

slugstring

Slug of the collection

descriptionobject

Desction of the collection

image_urlstring

Image URL of the collection

discord_urlstring

Discord URL of the collection

telegram_urlstring

Telegram URL of the collection

external_urlstring

External URL of the collection

twitter_usernamestring

Twitter username of the collection

instagram_usernamestring

Instagram username of the collection

feesarray of Fee (object)

Fee structure for all assets of this colletion

chainChainDetail (object)

assetsListAssetsResponse (object)

Request

JavaScriptCurlPython

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

Response

200400401403500

{
  "contract_address": "text",
  "owner": "text",
  "total_supply": 0,
  "category": {
    "category_id": "text",
    "category_name": "text"
  },
  "name": "text",
  "slug": "text",
  "image_url": "text",
  "discord_url": "text",
  "telegram_url": "text",
  "external_url": "text",
  "twitter_username": "text",
  "instagram_username": "text",
  "fees": [
    {
      "address": "text",
      "basis_points": 0,
      "type": "text"
    }
  ],
  "chain": {
    "id": "text",
    "name": "text",
    "symbol": "text"
  },
  "assets": {
    "cursor": "text",
    "remaining": 0,
    "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"
      }
    ]
  }
}

Update a collection

Update collection

Update collection

PUThttps://api.sandbox.horizonland.app/v1/collections/{address}

Path parameters

address*string

Collection contract address

Header parameters

Body

application/json

update a collection

namestring

Name of the collection

descriptionobject

Desction of the collection

image_urlstring

Image URL of the collection

discord_urlstring

Discord URL of the collection

telegram_urlstring

Telegram URL of the collection

external_urlstring

External URL of the collection

twitter_usernamestring

Twitter username of the collection

instagram_usernamestring

Instagram username of the collection

Response

200400401403404500

OK

Body

application/json

contract_addressstring

Contract address of the collection

ownerstring

Owner of the collection

total_supplynumber

Total supply of the collection

categoryCategoryDetail (object)

namestring

Name of the collection

slugstring

Slug of the collection

descriptionobject

Desction of the collection

image_urlstring

Image URL of the collection

discord_urlstring

Discord URL of the collection

telegram_urlstring

Telegram URL of the collection

external_urlstring

External URL of the collection

twitter_usernamestring

Twitter username of the collection

instagram_usernamestring

Instagram username of the collection

feesarray of Fee (object)

Fee structure for all assets of this colletion

chainChainDetail (object)

assetsListAssetsResponse (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.sandbox.horizonland.app/v1/collections/{address}', {
    method: 'PUT',
    headers: {
      "access token": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200400401403404500

{
  "contract_address": "text",
  "owner": "text",
  "total_supply": 0,
  "category": {
    "category_id": "text",
    "category_name": "text"
  },
  "name": "text",
  "slug": "text",
  "image_url": "text",
  "discord_url": "text",
  "telegram_url": "text",
  "external_url": "text",
  "twitter_username": "text",
  "instagram_username": "text",
  "fees": [
    {
      "address": "text",
      "basis_points": 0,
      "type": "text"
    }
  ],
  "chain": {
    "id": "text",
    "name": "text",
    "symbol": "text"
  },
  "assets": {
    "cursor": "text",
    "remaining": 0,
    "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"
      }
    ]
  }
}