Public API Documentation

Important Notes

• To access Minted Public API, you must apply for API keys by completing this form. API keys are necessary to authenticate your requests and monitor usage limits. Should you have any questions about requesting an API, please email [email protected].

• The rate limit for the API is set at five queries per second (QPS). Please ensure your application or software complies with this limit to avoid service disruption or suspension of your API keys.

• Minted does not provide technical support for the public API, but you may refer to the documentation in this article.

• Attribution to Minted is required when using the public API. Please refer to the Brand Assets & Usage article for guidelines on adequately attributing Minted.

• Minted reserves the right to revoke or limit API keys at any time for any reason, including but not limited to misuse or abuse of the API.

Limitation and Caching

The API rate limit is 5 QPS, and the cache will refresh every five minutes at most. As a result, collection stats may reflect data up to five minutes old, plus any additional time the data was cached. Minted does not guarantee the accuracy or timeliness of the data returned by the API and is not liable for any damages or losses resulting from its use.

Types of Data

Minted Public API provides access to two types of data:

1. A list of collection statistics

2. A single collection statistic

Depending on your needs, you can use the API to retrieve either type of data.

Get a List of Collection Statistics

API Path: https://public-api.minted.network/api/v1/collection/stats

Quickstart https://public-api.minted.network/api/v1/collection/stats?chain=CRONOS&offset=0&limit=50

Header X-Api-Key: MINTED_API_KEY

Request Parameters

Name	Is Required?	Type	Default value	Range of Values	Remark
limit	No	Number	10	1 to 50
offset	No	Number	0	0 to n
chain	No	String	X	CRONOS or ETHEREUM	If no chain is specified, returns the stats of all chains

Request Headers

Name	Is Required?	Type	Example Value
X-Api-Key	Yes	String	Your Minted Public API Key

Response

Name	Type	Description
root	Array	Response’s root is an array containing a list of collection statistics
address	address	Collection EVM Address
name	String	Collection name
currency	String	Currency for the token
symbol	String	null if the collection doesn't implement IERC721Metadata interface
description	String
standard	String	ERC721, ERC1155
logo_url	String	Logo URL of the collection hosted on Minted
total_supply	Number	Number of NFTs in this collection
website	String	Website URL
discord	String	Discord Invite ID
telegram	String	Telegram account ID
twitter	String	Twitter unique account handle
owner_count	Number	Number of owners of NFTs in this collection
floor_price	Number	Wei-based. Lowest valid Ask order price, `null` when no Ask order exists.
floor_price_change_one_day	Number
volume_one_day	Number
volume_seven_day	Number
volume_thirty_day	Number
volume_all_time	Number
volume_change_one_day	Number
volume_change_seven_days	Number
volume_change_one_month	Number

Raw JSON Response

[
    {
       "address": "0xe987b90494a9e6866106f12c4c53885ebc4e89af",
       "name": "Minted @ NFT London 2022",
       "currency": "0x5c7f8a570d578ed84e63fdfa7b1ee72deae1ae23",
       "symbol": "MTDNFTLDN",
       "description": "This collection celebrates Minted’s presence at NFT London 2022, as well as the announcement and reveal of the Minted Launchpad. Minted teamed up with the creative geniuses at Cronos Labs to create this delightful, commemorative NFT!",
       "logo_url": "https://images.minted.network/?image=a68ff1086e2dac764800f2510165d653315593bea1403f4dd9dbfc3f2b5305a9",
       "total_supply": 3333,
       "website": null,
       "discord": "DAXtMNhvKT",
       "telegram": "MintedNetwork",
       "twitter": "MintedNetwork",
       "owner_count": 1719,
       "floor_price": 16000000000000000000,
       "floor_price_change_one_day": 2000000000000000000,
       "volume_one_day": 276000000000000000000,
       "volume_seven_day": 468000000000000000000,
       "volume_thirty_day": 1187483980000000000000,
       "volume_all_time": 79823484149000000000000,
       "volume_change_one_day": 0.0,
       "volume_change_seven_days": 762.5,
       "volume_change_one_month": 0.0
   }


]

Get A Single Collection's Statistic

API Path: https://public-api.minted.network/api/v1/collection/stat

Quickstart https://public-api.minted.network/api/v1/collection/stat?chain=CRONOS&address=0xe987b90494a9e6866106f12c4c53885ebc4e89af

Header X-Api-Key: MINTED_API_KEY

Request Parameters

Name	Is Required?	Type	Default value	Range of Values	Remark
chain	Yes	String	X	CRONOS or ETHEREUM
address	Yes	String	X		Collection EVM Address

Request Headers

Name	Is Required?	Type	Example Value
X-Api-Key	Yes	String	Your Minted Public API Key

Response

Name	Type	Description
address	address	Collection EVM Address
name	String	Collection name
currency	String	Currency for the token
symbol	String	null if the collection doesn't implement IERC721Metadata interface
description	String
logo_url	String	Logo URL of the collection hosted on Minted
total_supply	Number	Number of NFTs in this collection
website	String	Website URL
discord	String	Discord Invite ID
telegram	String	Telegram account ID
twitter	String	Twitter unique account handle
owner_count	Number	Number of owners of NFTs in this collection
floor_price	Number	Wei-based. Lowest valid Ask order price, `null` when no Ask order exists.
floor_price_change_one_day	Number
volume_one_day	Number
volume_seven_day	Number
volume_thirty_day	Number
volume_all_time	Number
volume_change_one_day	Number
volume_change_seven_days	Number
volume_change_one_month	Number

Raw JSON Response

{
   "address": "0xe987b90494a9e6866106f12c4c53885ebc4e89af",
   "name": "Minted @ NFT London 2022",
   "currency": "0x5c7f8a570d578ed84e63fdfa7b1ee72deae1ae23",
   "symbol": "MTDNFTLDN",
   "description": "This collection celebrates Minted’s presence at NFT London 2022, as well as the announcement and reveal of the Minted Launchpad. Minted teamed up with the creative geniuses at Cronos Labs to create this delightful, commemorative NFT!",
   "logo_url": "https://images.minted.network/?image=a68ff1086e2dac764800f2510165d653315593bea1403f4dd9dbfc3f2b5305a9",
   "total_supply": 3333,
   "website": null,
   "discord": "DAXtMNhvKT",
   "telegram": "MintedNetwork",
   "twitter": "MintedNetwork",
   "owner_count": 1719,
   "floor_price": 17000000000000000000,
   "floor_price_change_one_day": 1000000000000000000,
   "volume_one_day": 57500000000000000000,
   "volume_seven_day": 464500000000000000000,
   "volume_thirty_day": 1147183980000000000000,
   "volume_all_time": 79850984149000000000000,
   "volume_change_one_day": -76.6260162601626,
   "volume_change_seven_days": 85.48387096774194,
   "volume_change_one_month": -3.8461538461538463
}

Get Individual NFT Information

API endpoint format: https://public-api.minted.network/api/v1//chain/{chain}/collection/{address}/tokenId/{tokenId}

Request Parameters

Chain	Yes	-	CRONOS or ETHEREUM
Address	Yes	String	-
TokenId	Yes	Number	-

Request Headers

Name	Is Required?	Type
X-api-key	Yes	String

Response

Name	Type	Description
chain	String	CRONOS or ETHEREUM
address	String	Contract address
tokenId	Number	-
name	String	NFT name
owner	String	NFT owner
imageUrl	String	Image URL of the NFT on Minted
originalImageUrl	String	Original image URL of the NFT
metadataUrl	String	Access to the URL of metadata
metadata	JSON	-
description	String	-