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. 1.
    A list of collection statistics
  2. 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

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
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

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
}