Public API Documentation
- 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.
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.
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.
Header X-Api-Key: MINTED_API_KEY
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 |
Name | Is Required? | Type | Example Value |
X-Api-Key | Yes | String | Your Minted Public API Key |
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 | |
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 |
[
{
"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
}
]
Header X-Api-Key: MINTED_API_KEY
Name | Is Required? | Type | Default value | Range of Values | Remark |
chain | Yes | String | X | CRONOS or ETHEREUM | |
address | Yes | String | X | Collection EVM Address |
Name | Is Required? | Type | Example Value |
X-Api-Key | Yes | String | Your Minted Public API Key |
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 |
{
"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
}