Making an API call (GET Methods)

How to get started using 1155Tech API to build with your own experiences

Good to know: This is a quick start guide for builders to jump right into using the APIs to get up and running in a few simple steps. For more detailed information on all the methods available, Check out the rest of API docs.

Get your API Key

How to get an API Key and what are the limitations?

• Go to 1155Tech discord

• Create a ticket using the ticket tool and explain your usecase.

• We will review and issue an API key (free of cost)

• API_KEY is required to access these APIs.

• APIs are rate limited to 10k requests per day. Rate limiting is applied across all the APIs.

• APIs are paginated wherever required.

Make your request

To make a request, send your API_KEY in the request header alongside required query parameters to the API endpoint you are using. On success, the API will return a parseable response.

Key Holders

GET http://api.1155.tech/public/api/v1/artist/key-holders

Get all Keyholders across all art markets created by the artist. This is a paginated API and accepts skip and limit as part of the query-string.

Query Parameters

Name	Type	Description
artistWallet*	String	Creator wallet address goes here. For e.g. 0x29d4b2b80a8de138d8dfdf415666501d0278aedd
skip	Number	Number of results to skip before returning items. Used to define pagination in your request.
limit	Number	Number of items to return per page e.g. 10

403: Forbidden Permission Denied

401: Unauthorized Unauthorised because of wrong API Key

200: OK List of Keyholders returned

Take a look at how you might want to pass on the API KEY via HTTP or curl

cURL

curl --location --request GET 'https://api.1155.tech/public/api/v1/artist/key-holders?artistWallet=0x29d4b2b80a8de138d8dfdf415666501d0278aedd' \
--header 'API_KEY: YOUR_API_KEY_HERE' \
--data-raw '' 

HTTP