API (Data & Analytics)
The Mintify API provides access to a wide range of data and insights for NFT-based economies, making it a valuable piece of NFT infrastructure for anyone looking to build their own products.
You can sign up for access to the Mintify API here: https://learn.mintify.xyz/api
To use our Blast API use this endpoint: https://api-blast.mintify.xyz
To use our Base API use this endpoint: https://api-base.mintify.xyz
To use our ETH API use this endpoint: https://api.mintify.xyz
To use our Ordinals API use this endpoint: https://api-ordinals.mintify.xyz
To use our Flow API use this endpoint: https://api-flow.mintify.xyz
To use our Apechain API use this endpoint: https://api-apechain.mintify.xyz/
To use our Abstract API use this endpoint: https://api-abstract.mintify.xyz
To use our Berachain API use this endpoint: https://api-berachain.mintify.xyz
Authentication: You need to include a 'API-KEY' header with every request:
headers = {
'API-KEY': 'YOUR_API_KEY'
}Returns a contract object
The limit of the list. Default value is 50. Max value is 1000.
GET /api/getActiveContracts HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*
Array containing Contract object
[
{
"contract_address": "text",
"name": "text",
"symbol": "text",
"type": "text",
"description": "text",
"image_url": "text",
"background_image_url": "text",
"holders": 1,
"quantity": 1,
"owner_address": "text",
"slug": "text",
"total_volume": 1,
"total_sales": 1,
"floor": 1,
"is_bluechip": 1,
"chain": "text",
"metas": {
"contract-verified": "text",
"discord-members": "text",
"looksrare-url": "text",
"mint-price": "text",
"opensea-slug": "text",
"project-discord": "text",
"project-instagram": "text",
"project-twitter": "text",
"rarible-url": "text",
"traits_done": "text",
"twitter-followers": "text",
"url": "text"
},
"firstTransaction": "text"
}
]Returns a contract object
The contract address
GET /api/getContract HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*
Array containing Contract object
[
{
"contract_address": "text",
"name": "text",
"symbol": "text",
"type": "text",
"description": "text",
"image_url": "text",
"background_image_url": "text",
"holders": 1,
"quantity": 1,
"owner_address": "text",
"slug": "text",
"total_volume": 1,
"total_sales": 1,
"floor": 1,
"is_bluechip": 1,
"chain": "text",
"metas": {
"contract-verified": "text",
"discord-members": "text",
"looksrare-url": "text",
"mint-price": "text",
"opensea-slug": "text",
"project-discord": "text",
"project-instagram": "text",
"project-twitter": "text",
"rarible-url": "text",
"traits_done": "text",
"twitter-followers": "text",
"url": "text"
},
"firstTransaction": "text"
}
]Returns volume and sales datapoints for contract
The contract address
The chain the list is for. Currently only "eth" is accepted.
ethThe period of the list. Default value is "24h". Accepted values are: "60d", "30d", "15d", "7d", "48h", "24h", "12h", "4h", "2h", "1h", "15m", "5m"
24hGET /api/getContractDatapoints HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*
Array of datapoints.
{
"volumes": {
"dateTime": 1
},
"sales": {
"dateTime": 1
},
"lsps": {
"dateTime": 1
},
"individualSales": [
{
"dateTime": 1,
"time": "text",
"price": 1,
"tokenId": "text",
"rank": 1,
"image": "text",
"transactionHash": "text",
"rarityPercential": 1
}
]
}Returns floor datapoints for a contract
The contract address
The period of the list. Default value is "24h". Accepted values are: "60d", "30d", "15d", "7d", "48h", "24h", "12h", "4h", "2h", "1h", "15m", "5m"
24hGET /api/getContractFloorDatapoints HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*
Array datapoints
{
"marketName": {
"dateTime": 1
}
}Returns a list of trending contracts based on period and volume or sales
The period of the list. Default value is "24h". Accepted values are: "60d", "30d", "15d", "7d", "24h", "1h"
The chain the list is for. Currently only "eth" is accepted.
ethSort the results by this value. Default value is "sales". Accepted values are: "sales", "volume"
salesorder the results by this value. Default value is "DESC". Accepted values are: "DESC", "ASC"
DESCThe response limit. Default value is 25. Max value is 1000.
25The page number of the results, used in conjuction with limit. Default value is 1
1GET /api/getTrendingContracts HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*
Array of contract objects.
{
"contractAddress": {
"contract_address": "text",
"sales": 1,
"volume": 1,
"chain": "text",
"floor": 1,
"image_url": "text",
"background_image_url": "text",
"name": "text",
"metas": {
"contract-verified": "text",
"discord-members": "text",
"looksrare-url": "text",
"mint-price": "text",
"opensea-slug": "text",
"project-discord": "text",
"project-instagram": "text",
"project-twitter": "text",
"rarible-url": "text",
"traits_done": "text",
"twitter-followers": "text",
"url": "text"
},
"floor_24h": 1,
"floor_1h": 1,
"volume_1h": 1,
"firstTransaction": "text",
"items": 1,
"owners": 1
}
}Returns contract listings
The contract address
The ordering of the tokens. Possible values: "date_desc", "date_asc", "price_desc", "price_asc". Defaults to "date_desc".
date_descFilter results by specific market place. Accepted values: "opensea", "coinbase", "looksrare", "rarible", "x2y2", "reservoir", "sudoswap"
allFilter the results by a minimum price. Default value is 0
0Filter the results by a maximum price. Default value is 1000 which is also the maximum allowed.
1000The response limit. Default value is 25. Max value is 1000.
25The page number of the results, used in conjuction with limit. Default value is 1
1GET /api/getContractListings HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*
Array of listing objects.
[
{
"id": 1,
"contract_address": "text",
"token_id": "text",
"price": 1,
"owner": "text",
"quantity": 1,
"chain": "text",
"time": "text",
"market": "text",
"listing_date": "text",
"expiration": "text",
"currency": null,
"name": "text",
"image": "text",
"raw_image": "text",
"traits": [
{
"value": null,
"trait_type": null
}
],
"rank": 1,
"tokenFlagged": 1,
"last_sale": 1,
"rarityPercential": 1
}
]Returns contract activity
The contract address
The type of activity. Possible values: "all", "sales", "transfers", "mints", "burns". Defaults to "all".
allThe response limit. Default value is 25. Min value is 1, Max value is 1000.
25The page number of the results, used in conjuction with limit. Default value is 1
1GET /api/getContractActivity HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*
Array of listing objects.
[]Returns contract bids
The contract address
The ordering of the tokens. Possible values: "date_desc", "date_asc", "price_desc", "price_asc". Defaults to "date_desc".
date_descFilter results by specific market place. Accepted values: "opensea", "coinbase", "looksrare", "rarible", "x2y2", "reservoir", "sudoswap"
allFilter results by offer type. Accepted values: "all", "tokens", "collection"
allFilter the results by a minimum price. Default value is 0
0Filter the results by a maximum price. Default value is 1000 which is also the maximum allowed.
1000The response limit. Default value is 25. Max value is 1000.
25The page number of the results, used in conjuction with limit. Default value is 1
1GET /api/getContractBids HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*
Array of listing objects.
[
{
"id": 1,
"contract_address": "text",
"token_id": "text",
"chain": "text",
"time": "text",
"expiration_date": "text",
"price": 1,
"currency": "text",
"market": "text",
"maker": "text",
"name": "text",
"image": "text",
"raw_image": "text",
"traits": [
{
"value": null,
"trait_type": null
}
],
"rank": 1,
"tokenFlagged": 1,
"last_sale": 1
}
]Returns tokens for a contract.
The contract address
Filter by specific token ids. This is a json encoded array of ids.
The response limit. Default value is 25. Max value is 1000.
25The page number of the results, used in conjuction with limit. Default value is 1
1GET /api/getContractTokens HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*
Array of token objects.
{
"contract_address": "text",
"token_id": "text",
"owner": "text",
"transaction_hash": "text",
"last_block": 1,
"time": "text",
"image": "text",
"raw_image": "text",
"name": "text",
"traits": [
{
"value": null,
"trait_type": null
}
],
"rank": 1,
"chain": "text",
"is_flagged": 1,
"last_sale": 1
}Returns a list of upcoming collections. This endpoint has been deprecated in favor of /getUpcomingCollections.
The chain of the upcoming drops. Currently only "eth" is accepted.
ethThe page of the results, used for pagination.
1Filter the results by category id. Accepted categories: art: 3, photography: 4, metaverse: 5, games: 6, music: 7, utility: 8, popular: 9, free mints: 10
GET /api/getUpcomingDrops HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*
Array of collection objects.
[
{
"id": 1,
"name": "text",
"description": "text",
"url": "text",
"contract_address": "text",
"verified": "text",
"image_url": "text",
"banner_image_url": "text",
"price": 1,
"currency": "text",
"quantity": 1,
"drop_date": "text",
"drop_type": "text",
"votes": "text",
"categories": [
"text"
],
"potential": {
"team_score": 1,
"community_score": 1,
"roadmap_score": 1,
"utility_score": 1,
"art_score": 1,
"marketing_score": 1,
"flip_potential": 1
},
"metas": {
"twitter": "text",
"twitter_followers": "text",
"discord_members": "text",
"discord_url": "text",
"doxxed_creators": "text",
"website_url": "text",
"opensea_url": "text",
"rarible_url": "text",
"looksrare_url": "text",
"instagram_url": "text"
}
}
]Returns a list of upcoming collections. This endpoint has been deprecated in favor of /getUpcomingCollectionsContract
The chain of the upcoming drops. Currently only "eth" is accepted.
ethA comma separated string of post ids. Maximum ids that can be passed is 50.
GET /api/getUpcomingDropsContracts HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*
Array of post_id to contract_address objects.
[
{
"post_id": 1,
"contract_address": "text",
"drop_date": "text",
"status": "text"
}
]Returns a list of upcoming collections.
The wallet address.
The chain of the upcoming drops. Currently only "eth" is accepted.
ethThe page number, used for pagination.
1The limit of the response. Max is 50
50GET /api/getWalletTokens HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*
Array of token objects.
[
{
"contract_address": "text",
"token_id": "text",
"image": "text",
"raw_image": "text",
"name": "text",
"traits": [
{
"trait_type": null,
"value": null
}
],
"rank": 1,
"chain": "text",
"last_sale": 1
}
]Returns blockchain activity for the last 100 blocks.
The activity type. Possible values are: "all", "sales", "transfers", "mints", "burns". Defaults to "all".
allThe page number, used for pagination.
1The limit of the response. Max is 100
50GET /api/getChainActivity HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*
Array of transaction objects.
[
{
"contract_address": "text",
"token_id": "text",
"transaction_hash": "text",
"block_number": "text",
"value": 1,
"quantity": 1,
"from_address": "text",
"to_address": "text",
"contractImage": "text"
}
]Returns a list of upcoming collections.
The chain of the upcoming drops.
ethThe page of the results, used for pagination.
1Filter the results by category. Accepted Categories: art, photography, metaverse, games, music, utility, popular, free mints, mintify-launchpad
GET /api/getUpcomingCollections HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*
Array of collection objects.
[
{
"id": 1,
"status": "text",
"date_created": "text",
"date_updated": "text",
"title": "text",
"description": "text",
"image": "text",
"chain": "text",
"drop_date": 1,
"mint_price": "text",
"currency": 1,
"supply": "text",
"twitter_handle": "text",
"website": "text",
"discord": "text",
"twitter_followers": "text",
"opensea_slug": "text",
"categories": [
"text"
],
"contract_address": "text"
}
]Returns an upcoming collection.
The chain of the upcoming drops.
ethThe id of the upcoming collection.
GET /api/getUpcomingCollection HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*
Array of post_id to contract_address objects.
{
"id": 1,
"status": "text",
"date_created": "text",
"date_updated": "text",
"title": "text",
"description": "text",
"image": "text",
"chain": "text",
"drop_date": 1,
"mint_price": "text",
"currency": 1,
"supply": "text",
"twitter_handle": "text",
"website": "text",
"discord": "text",
"twitter_followers": "text",
"opensea_slug": "text",
"categories": [
"text"
],
"contract_address": "text"
}Last updated