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

Authentication: You need to include a 'API-KEY' header with every request:

headers = {
'API-KEY': 'YOUR_API_KEY'
}

Returns a contract object

get

/getActiveContracts

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",
    "firstTransaction": "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"
    }
  }
]

Array containing Contract object

Returns a contract object

get

/getContract

Authorizations

Query parameters

contractstringrequired

The contract address

chainstring · default: eth

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

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",
    "firstTransaction": "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"
    }
  }
]

Array containing Contract object

Returns volume and sales datapoints for contract

get

/getContractDatapoints

Authorizations

Query parameters

contractstringrequired

The contract address

chainstring · default: eth

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

periodstring · default: 24h

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.

Returns floor datapoints for a contract

get

/getContractFloorDatapoints

Authorizations

Query parameters

contractstringrequired

The contract address

chainstring · default: eth

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

periodstring · default: 24h

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

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

get

/getTrendingContracts

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

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

sortBystring · default: sales

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

orderstring · default: DESC

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

limitnumber · default: 25

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

pagenumber · default: 1

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",
    "floor_24h": 1,
    "floor_1h": 1,
    "volume_1h": 1,
    "firstTransaction": "text",
    "items": 1,
    "owners": 1,
    "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"
    }
  }
}

Array of contract objects.

Returns contract listings

get

/getContractListings

Authorizations

Query parameters

contractstringrequired

The contract address

chainstring · default: eth

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

tokensOrderstring · default: date_desc

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

marketstring · default: all

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

priceminnumber

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

pricemaxnumber · default: 1000

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

limitnumber · default: 25

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

pagenumber · default: 1

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",
    "rank": 1,
    "tokenFlagged": 1,
    "last_sale": 1,
    "rarityPercential": 1,
    "traits": [
      {
        "value": null,
        "trait_type": null
      }
    ]
  }
]

Array of listing objects.

Returns contract activity

get

/getContractActivity

Authorizations

Query parameters

contractstringrequired

The contract address

chainstring · default: eth

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

typestring · default: all

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

limitnumber · default: 25

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

pagenumber · default: 1

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.

Returns contract bids

get

/getContractBids

Authorizations

Query parameters

contractstringrequired

The contract address

chainstring · default: eth

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

tokensOrderstring · default: date_desc

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

marketstring · default: all

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

typestring · default: all

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

priceminnumber

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

pricemaxnumber · default: 1000

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

limitnumber · default: 25

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

pagenumber · default: 1

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",
    "rank": 1,
    "tokenFlagged": 1,
    "last_sale": 1,
    "traits": [
      {
        "value": null,
        "trait_type": null
      }
    ]
  }
]

Array of listing objects.

get

/getContractTokens

Authorizations

Query parameters

contractstringrequired

The contract address

chainstring · default: eth

The chain the contract is on. Currently only "eth" is accepted.

tokenIdsstring

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

limitnumber · default: 25

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

pagenumber · default: 1

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",
  "rank": 1,
  "chain": "text",
  "is_flagged": 1,
  "last_sale": 1,
  "traits": [
    {
      "value": null,
      "trait_type": null
    }
  ]
}

Array of token objects.

get

/getUpcomingDrops

Authorizations

Query parameters

chainstring · default: eth

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

pagenumber · default: 1

The page of the results, used for pagination.

categorynumber

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

/getUpcomingDropsContracts

Authorizations

Query parameters

chainstring · default: eth

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

post_idsstring

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

/getWalletTokens

Authorizations

Query parameters

walletstring

The wallet address.

chainstring · default: eth

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

pagenumber · default: 1

The page number, used for pagination.

limitnumber · default: 50

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",
    "rank": 1,
    "chain": "text",
    "last_sale": 1,
    "traits": [
      {
        "trait_type": null,
        "value": null
      }
    ]
  }
]

Array of token objects.

get

/getChainActivity

Authorizations

Query parameters

typestring · default: all

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

pagenumber · default: 1

The page number, used for pagination.

limitnumber · default: 50

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.

post

/getAlphabotUpdate

Authorizations

Query parameters

dataobject

Contains raffle data

eventstring

Event type

Responses

cURL

JavaScript

Python

HTTP

cURL

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

200

200

No body

undifined