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

GEThttps://api.mintify.xyz/api/getActiveContracts

Query parameters

Response

200

Array containing Contract object

Body

application/json

contract_addressstring

The contract address

namestring

The contract name

symbolstring

The contract symbol

typestring

The contract type ex. ERC721 or ERC1155

descriptionstring

The contract description

image_urlstring

The contract image url

background_image_urlstring

The contract banner image url

holdersinteger

The total number of token holders

quantityinteger

The total number of tokens

owner_addressstring

The contract owner address

slugstring

The contract opensea slug

total_volumenumber

The total volume in eth

total_salesinteger

The total number of sales

floornumber

The floor price

is_bluechipinteger

Contract is bluechip

chainstring

The contract chain

metasobject

firstTransactionstring

The date of the first transaction

Request

JavaScriptCurlPython

const response = await fetch('https://api.mintify.xyz/api/getActiveContracts?limit=0', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "contract_address": "text",
    "name": "text",
    "symbol": "text",
    "type": "text",
    "description": "text",
    "image_url": "text",
    "background_image_url": "text",
    "owner_address": "text",
    "slug": "text",
    "total_volume": 0,
    "floor": 0,
    "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

GEThttps://api.mintify.xyz/api/getContract

Query parameters

Response

200

Array containing Contract object

Body

application/json

contract_addressstring

The contract address

namestring

The contract name

symbolstring

The contract symbol

typestring

The contract type ex. ERC721 or ERC1155

descriptionstring

The contract description

image_urlstring

The contract image url

background_image_urlstring

The contract banner image url

holdersinteger

The total number of token holders

quantityinteger

The total number of tokens

owner_addressstring

The contract owner address

slugstring

The contract opensea slug

total_volumenumber

The total volume in eth

total_salesinteger

The total number of sales

floornumber

The floor price

is_bluechipinteger

Contract is bluechip

chainstring

The contract chain

metasobject

firstTransactionstring

The date of the first transaction

Request

JavaScriptCurlPython

const response = await fetch('https://api.mintify.xyz/api/getContract?contract=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "contract_address": "text",
    "name": "text",
    "symbol": "text",
    "type": "text",
    "description": "text",
    "image_url": "text",
    "background_image_url": "text",
    "owner_address": "text",
    "slug": "text",
    "total_volume": 0,
    "floor": 0,
    "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

GEThttps://api.mintify.xyz/api/getContractDatapoints

Query parameters

Response

200

Array of datapoints.

Body

application/json

volumesobject

salesobject

lspsobject

individualSalesarray of object

Request

JavaScriptCurlPython

const response = await fetch('https://api.mintify.xyz/api/getContractDatapoints?contract=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "volumes": {
    "dateTime": 0
  },
  "sales": {},
  "lsps": {
    "dateTime": 0
  },
  "individualSales": [
    {
      "time": "text",
      "price": 0,
      "tokenId": "text",
      "image": "text",
      "transactionHash": "text"
    }
  ]
}

Returns floor datapoints for a contract

GEThttps://api.mintify.xyz/api/getContractFloorDatapoints

Query parameters

Response

200

Array datapoints

Body

application/json

marketNameobject

The market name

Request

JavaScriptCurlPython

const response = await fetch('https://api.mintify.xyz/api/getContractFloorDatapoints?contract=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "marketName": {
    "dateTime": 0
  }
}

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

GEThttps://api.mintify.xyz/api/getTrendingContracts

Query parameters

Response

200

Array of contract objects.

Body

application/json

contractAddressobject

The contract object

Request

JavaScriptCurlPython

const response = await fetch('https://api.mintify.xyz/api/getTrendingContracts?period=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "contractAddress": {
    "contract_address": "text",
    "volume": 0,
    "chain": "text",
    "floor": 0,
    "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": 0,
    "floor_1h": 0,
    "volume_1h": 0,
    "firstTransaction": "text"
  }
}

Returns contract listings

GEThttps://api.mintify.xyz/api/getContractListings

Query parameters

Response

200

Array of listing objects.

Body

application/json

idinteger

The listing unique id

contract_addressstring

The contract address

token_idstring

The token id

pricenumber

The listing price

ownerstring

The address of the contract owner

quantityinteger

The quantity of tokens in this listing

chainstring

The chain this listing is on

timestring

The datetime this listing was created

marketstring

The market this listing was created on

listing_datestring

The listing start date

expirationstring

The listing expiration date

currencysting

The listing currency

namestring

The token name

imagestring

The converted image url

raw_imagestring

The raw image url

traitsarray of object

rankinteger

The rank of the token

tokenFlaggedinteger

The flagged status of the token. 1 is flagged, 0 is not flagged

last_salenumber

The last sale price of the token

rarityPercentialnumber

The rarity percentile of the token

Request

JavaScriptCurlPython

const response = await fetch('https://api.mintify.xyz/api/getContractListings?contract=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "contract_address": "text",
    "token_id": "text",
    "price": 0,
    "owner": "text",
    "chain": "text",
    "time": "text",
    "market": "text",
    "listing_date": "text",
    "expiration": "text",
    "name": "text",
    "image": "text",
    "raw_image": "text",
    "traits": [
      {}
    ],
    "last_sale": 0,
    "rarityPercential": 0
  }
]

Returns contract activity

GEThttps://api.mintify.xyz/api/getContractActivity

Query parameters

Response

200

Array of listing objects.

Body

application/json

itemsany

Request

JavaScriptCurlPython

const response = await fetch('https://api.mintify.xyz/api/getContractActivity?contract=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[]

Returns contract bids

GEThttps://api.mintify.xyz/api/getContractBids

Query parameters

Response

200

Array of listing objects.

Body

application/json

idinteger

The unique id of the offer

contract_addressstring

The contract address

token_idstring

The token id the offer is for. If "all", its a collection-wide offer

chainstring

The contract chain

timestring

The datetime the offer was created on

expiration_datestring

The datetime the offer expires

pricenumber

The offer price

currencystring

The currency of the offer

marketstring

The market the offer was placed on

makerstring

The maker address of the offer

namestring

The token name

imagestring

The token converted image url

raw_imagestring

The token raw image url

traitsarray of object

rankinteger

The token rank

tokenFlaggedinteger

The flagged status of the token. 1 is flagged, 0 is not flagged

last_salenumber

The last sale price of the token

Request

JavaScriptCurlPython

const response = await fetch('https://api.mintify.xyz/api/getContractBids?contract=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "contract_address": "text",
    "token_id": "text",
    "chain": "text",
    "time": "text",
    "expiration_date": "text",
    "price": 0,
    "currency": "text",
    "market": "text",
    "maker": "text",
    "name": "text",
    "image": "text",
    "raw_image": "text",
    "traits": [
      {}
    ],
    "last_sale": 0
  }
]

GEThttps://api.mintify.xyz/api/getContractTokens

Query parameters

Response

200

Array of token objects.

Body

application/json

contract_addressstring

The contract address

token_idstring

The token id

ownerstring

The token owner address

transaction_hashstring

The last transaction hash

last_blockinteger

The last block the token was on

timestring

The datetime of the last transfer

imagestring

The converted image url

raw_imagestring

The raw image url

namestring

The token name

traitsarray of object

rankinteger

The rank of the token

chainstring

The chain the token is on

is_flaggedinteger

The flagged status of the token. 1 is flagged, 0 is not flagged

last_salenumber

The token last sale price

Request

JavaScriptCurlPython

const response = await fetch('https://api.mintify.xyz/api/getContractTokens?contract=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "contract_address": "text",
  "token_id": "text",
  "owner": "text",
  "transaction_hash": "text",
  "time": "text",
  "image": "text",
  "raw_image": "text",
  "name": "text",
  "traits": [
    {}
  ],
  "chain": "text",
  "last_sale": 0
}

GEThttps://api.mintify.xyz/api/getUpcomingDrops

Query parameters

Response

200

Array of collection objects.

Body

application/json

idinteger

The unique id of the upcoming drop

namestring

The upcoming drop name

descriptionstring

The upcoming drop description

urlstring

The upcoming drop url on mintify

contract_addressstring

The upcoming drop contract address

verifiedstring

The upcoming drop verified status. 1 is verified.

image_urlstring

The upcoming drop image url

banner_image_urlstring

The upcoming drop banner image url

pricenumber

The upcoming drop mint/presale price

currencystring

The upcoming drop currency

quantityinteger

The upcoming drop quantity/supply

drop_datestring

The upcoming drop date

drop_typestring

The upcoming drop type

votesstring

The upcoming drop total number of votes on mintify

categoriesarray of string

The upcoming drop categories

potentialobject

The potential metrics of the upcoming drop

metasobject

Meta values for the upcoming drop

Request

JavaScriptCurlPython

const response = await fetch('https://api.mintify.xyz/api/getUpcomingDrops', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "name": "text",
    "description": "text",
    "url": "text",
    "contract_address": "text",
    "verified": "text",
    "image_url": "text",
    "banner_image_url": "text",
    "price": 0,
    "currency": "text",
    "drop_date": "text",
    "drop_type": "text",
    "votes": "text",
    "categories": [
      "text"
    ],
    "potential": {},
    "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"
    }
  }
]

GEThttps://api.mintify.xyz/api/getUpcomingDropsContracts

Query parameters

Response

200

Array of post_id to contract_address objects.

Body

application/json

post_idinteger

The unique id of the upcoming drop

contract_addressstring

The upcoming drop contract_address

drop_datestring

The drop date

statusstring

The publish status. published or unpublished

Request

JavaScriptCurlPython

const response = await fetch('https://api.mintify.xyz/api/getUpcomingDropsContracts', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

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

GEThttps://api.mintify.xyz/api/getWalletTokens

Query parameters

Response

200

Array of token objects.

Body

application/json

contract_addressstring

The contract address of the token

token_idstring

The token id

imagestring

The token image url

raw_imagestring

The token raw image url

namestring

The token name

traitsarray of object

The token traits

rankinteger

The token rank

chainstring

The token chain

last_salenumber

The token last sale price

Request

JavaScriptCurlPython

const response = await fetch('https://api.mintify.xyz/api/getWalletTokens', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "contract_address": "text",
    "token_id": "text",
    "image": "text",
    "raw_image": "text",
    "name": "text",
    "traits": [
      {}
    ],
    "chain": "text",
    "last_sale": 0
  }
]

GEThttps://api.mintify.xyz/api/getChainActivity

Query parameters

Response

200

Array of transaction objects.

Body

application/json

contract_addressstring

The contract address of the token

token_idstring

The token id

transaction_hashstring

The tx hash

block_numberstring

The block number the transaction was in

valuenumber

The value of the transaction

quantitynumber

The quantity of items

from_addressstring

The from address

to_addressstring

The to address

contractImagestring

The contract image

Request

JavaScriptCurlPython

const response = await fetch('https://api.mintify.xyz/api/getChainActivity', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

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

POSThttps://api.mintify.xyz/api/getAlphabotUpdate

Query parameters

Response

200

undifined

Request

JavaScriptCurlPython

const response = await fetch('https://api.mintify.xyz/api/getAlphabotUpdate', {
    method: 'POST',
    headers: {},
});
const data = await response.json();