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

get

Returns a contract object

Authorizations

Query parameters

limitnumberrequired

The limit of the list. Default value is 50. Max value is 1000.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.mintify.xyz/api/getActiveContracts?limit=1' \
  --header 'API-KEY: YOUR_API_KEY'

200

200

[
  {
    "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"
  }
]

Array containing Contract object

get

Returns a contract object

Authorizations

Query parameters

contractstringrequired

The contract address

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.mintify.xyz/api/getContract?contract=text' \
  --header 'API-KEY: YOUR_API_KEY'

200

200

[
  {
    "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"
  }
]

Array containing Contract object

get

Returns volume and sales datapoints for contract

Authorizations

Query parameters

contractstringrequired

The contract address

chainstring · default: "eth"optional

The chain the list is for. Currently only "eth" is accepted.

periodstring · default: "24h"optional

The period of the list. Default value is "24h". Accepted values are: "60d", "30d", "15d", "7d", "48h", "24h", "12h", "4h", "2h", "1h", "15m", "5m"

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.mintify.xyz/api/getContractDatapoints?contract=text' \
  --header 'API-KEY: YOUR_API_KEY'

200

200

{
  "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
    }
  ]
}

Array of datapoints.

get

Returns floor datapoints for a contract

Authorizations

Query parameters

contractstringrequired

The contract address

periodstring · default: "24h"optional

The period of the list. Default value is "24h". Accepted values are: "60d", "30d", "15d", "7d", "48h", "24h", "12h", "4h", "2h", "1h", "15m", "5m"

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.mintify.xyz/api/getContractFloorDatapoints?contract=text' \
  --header 'API-KEY: YOUR_API_KEY'

200

200

{
  "marketName": {
    "dateTime": 1
  }
}

Array datapoints

get

Returns a list of trending contracts based on period and volume or sales

Authorizations

Query parameters

periodstringrequired

The period of the list. Default value is "24h". Accepted values are: "60d", "30d", "15d", "7d", "24h", "1h"

chainstring · default: "eth"optional

The chain the list is for. Currently only "eth" is accepted.

sortBystring · default: "sales"optional

Sort the results by this value. Default value is "sales". Accepted values are: "sales", "volume"

orderstring · default: "DESC"optional

order the results by this value. Default value is "DESC". Accepted values are: "DESC", "ASC"

limitnumber · default: 25optional

The response limit. Default value is 25. Max value is 1000.

pagenumber · default: 1optional

The page number of the results, used in conjuction with limit. Default value is 1

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.mintify.xyz/api/getTrendingContracts?period=text' \
  --header 'API-KEY: YOUR_API_KEY'

200

200

{
  "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
  }
}

Array of contract objects.

get

Returns contract listings

Authorizations

Query parameters

contractstringrequired

The contract address

tokensOrderstring · default: "date_desc"optional

The ordering of the tokens. Possible values: "date_desc", "date_asc", "price_desc", "price_asc". Defaults to "date_desc".

marketstring · default: "all"optional

Filter results by specific market place. Accepted values: "opensea", "coinbase", "looksrare", "rarible", "x2y2", "reservoir", "sudoswap"

priceminnumber · default: 0optional

Filter the results by a minimum price. Default value is 0

pricemaxnumber · default: 1000optional

Filter the results by a maximum price. Default value is 1000 which is also the maximum allowed.

limitnumber · default: 25optional

The response limit. Default value is 25. Max value is 1000.

pagenumber · default: 1optional

The page number of the results, used in conjuction with limit. Default value is 1

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.mintify.xyz/api/getContractListings?contract=text' \
  --header 'API-KEY: YOUR_API_KEY'

200

200

[
  {
    "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
  }
]

Array of listing objects.

get

Returns contract activity

Authorizations

Query parameters

contractstringrequired

The contract address

typestring · default: "all"optional

The type of activity. Possible values: "all", "sales", "transfers", "mints", "burns". Defaults to "all".

limitnumber · default: 25optional

The response limit. Default value is 25. Min value is 1, Max value is 1000.

pagenumber · default: 1optional

The page number of the results, used in conjuction with limit. Default value is 1

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.mintify.xyz/api/getContractActivity?contract=text' \
  --header 'API-KEY: YOUR_API_KEY'

200

200

[]

Array of listing objects.

get

Returns contract bids

Authorizations

Query parameters

contractstringrequired

The contract address

tokensOrderstring · default: "date_desc"optional

The ordering of the tokens. Possible values: "date_desc", "date_asc", "price_desc", "price_asc". Defaults to "date_desc".

marketstring · default: "all"optional

Filter results by specific market place. Accepted values: "opensea", "coinbase", "looksrare", "rarible", "x2y2", "reservoir", "sudoswap"

typestring · default: "all"optional

Filter results by offer type. Accepted values: "all", "tokens", "collection"

priceminnumber · default: 0optional

Filter the results by a minimum price. Default value is 0

pricemaxnumber · default: 1000optional

Filter the results by a maximum price. Default value is 1000 which is also the maximum allowed.

limitnumber · default: 25optional

The response limit. Default value is 25. Max value is 1000.

pagenumber · default: 1optional

The page number of the results, used in conjuction with limit. Default value is 1

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.mintify.xyz/api/getContractBids?contract=text' \
  --header 'API-KEY: YOUR_API_KEY'

200

200

[
  {
    "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
  }
]

Array of listing objects.

get

Returns tokens for a contract.

Authorizations

Query parameters

contractstringrequired

The contract address

tokenIdsstringoptional

Filter by specific token ids. This is a json encoded array of ids.

limitnumber · default: 25optional

The response limit. Default value is 25. Max value is 1000.

pagenumber · default: 1optional

The page number of the results, used in conjuction with limit. Default value is 1

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.mintify.xyz/api/getContractTokens?contract=text' \
  --header 'API-KEY: YOUR_API_KEY'

200

200

{
  "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
}

Array of token objects.

get

Returns a list of upcoming collections. This endpoint has been deprecated in favor of /getUpcomingCollections.

Authorizations

Query parameters

chainstring · default: "eth"optional

The chain of the upcoming drops. Currently only "eth" is accepted.

pagenumber · default: 1optional

The page of the results, used for pagination.

categorynumberoptional

Filter the results by category id. Accepted categories: art: 3, photography: 4, metaverse: 5, games: 6, music: 7, utility: 8, popular: 9, free mints: 10

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.mintify.xyz/api/getUpcomingDrops' \
  --header 'API-KEY: YOUR_API_KEY'

200

200

[
  {
    "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"
    }
  }
]

Array of collection objects.

get

Returns a list of upcoming collections. This endpoint has been deprecated in favor of /getUpcomingCollectionsContract

Authorizations

Query parameters

chainstring · default: "eth"optional

The chain of the upcoming drops. Currently only "eth" is accepted.

post_idsstringoptional

A comma separated string of post ids. Maximum ids that can be passed is 50.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.mintify.xyz/api/getUpcomingDropsContracts' \
  --header 'API-KEY: YOUR_API_KEY'

200

200

[
  {
    "post_id": 1,
    "contract_address": "text",
    "drop_date": "text",
    "status": "text"
  }
]

Array of post_id to contract_address objects.

get

Returns a list of upcoming collections.

Authorizations

Query parameters

walletstringoptional

The wallet address.

chainstring · default: "eth"optional

The chain of the upcoming drops. Currently only "eth" is accepted.

pagenumber · default: 1optional

The page number, used for pagination.

limitnumber · default: 50optional

The limit of the response. Max is 50

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.mintify.xyz/api/getWalletTokens' \
  --header 'API-KEY: YOUR_API_KEY'

200

200

[
  {
    "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
  }
]

Array of token objects.

get

Returns blockchain activity for the last 100 blocks.

Authorizations

Query parameters

typestring · default: "all"optional

The activity type. Possible values are: "all", "sales", "transfers", "mints", "burns". Defaults to "all".

pagenumber · default: 1optional

The page number, used for pagination.

limitnumber · default: 50optional

The limit of the response. Max is 100

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.mintify.xyz/api/getChainActivity' \
  --header 'API-KEY: YOUR_API_KEY'

200

200

[
  {
    "contract_address": "text",
    "token_id": "text",
    "transaction_hash": "text",
    "block_number": "text",
    "value": 1,
    "quantity": 1,
    "from_address": "text",
    "to_address": "text",
    "contractImage": "text"
  }
]

Array of transaction objects.

get

Returns a list of upcoming collections.

Authorizations

Query parameters

chainstring · default: "eth"optional

The chain of the upcoming drops.

pagenumber · default: 1optional

The page of the results, used for pagination.

categorystringoptional

Filter the results by category. Accepted Categories: art, photography, metaverse, games, music, utility, popular, free mints, mintify-launchpad

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.mintify.xyz/api/getUpcomingCollections' \
  --header 'API-KEY: YOUR_API_KEY'

200

200

[
  {
    "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"
  }
]

Array of collection objects.

get

Returns an upcoming collection.

Authorizations

Query parameters

chainstring · default: "eth"optional

The chain of the upcoming drops.

idstringoptional

The id of the upcoming collection.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.mintify.xyz/api/getUpcomingCollection' \
  --header 'API-KEY: YOUR_API_KEY'

200

200

{
  "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"
}

Array of post_id to contract_address objects.