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.

PreviousAPI (Programmatic Trading)NextBrand Assets

Last updated 2 months ago

get

Returns a contract object

Authorizations

Query parameters

limitnumberRequired

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

Responses

200

Array containing Contract object

application/json

get

GET /api/getActiveContracts HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*

200

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

get

Returns a contract object

Authorizations

Query parameters

contractstringRequired

The contract address

Responses

200

Array containing Contract object

application/json

get

GET /api/getContract HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*

200

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

get

Returns volume and sales datapoints for contract

Authorizations

Query parameters

contractstringRequired

The contract address

chainstringOptional

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

Default: eth

periodstringOptional

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

Default: 24h

Responses

200

Array of datapoints.

application/json

get

GET /api/getContractDatapoints HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*

200

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

get

Returns floor datapoints for a contract

Authorizations

Query parameters

contractstringRequired

The contract address

periodstringOptional

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

Default: 24h

Responses

200

Array datapoints

application/json

get

GET /api/getContractFloorDatapoints HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*

200

Array datapoints

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

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"

chainstringOptional

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

Default: eth

sortBystringOptional

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

Default: sales

orderstringOptional

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

Default: DESC

limitnumberOptional

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

Default: 25

pagenumberOptional

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

Default: 1

Responses

200

Array of contract objects.

application/json

get

GET /api/getTrendingContracts HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*

200

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

get

Returns contract listings

Authorizations

Query parameters

contractstringRequired

The contract address

tokensOrderstringOptional

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

Default: date_desc

marketstringOptional

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

Default: all

priceminnumberOptional

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

Default: 0

pricemaxnumberOptional

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

Default: 1000

limitnumberOptional

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

Default: 25

pagenumberOptional

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

Default: 1

Responses

200

Array of listing objects.

application/json

get

GET /api/getContractListings HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*

200

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

get

Returns contract activity

Authorizations

Query parameters

contractstringRequired

The contract address

typestringOptional

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

Default: all

limitnumberOptional

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

Default: 25

pagenumberOptional

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

Default: 1

Responses

200

Array of listing objects.

application/json

get

GET /api/getContractActivity HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*

200

Array of listing objects.

[]

get

Returns contract bids

Authorizations

Query parameters

contractstringRequired

The contract address

tokensOrderstringOptional

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

Default: date_desc

marketstringOptional

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

Default: all

typestringOptional

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

Default: all

priceminnumberOptional

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

Default: 0

pricemaxnumberOptional

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

Default: 1000

limitnumberOptional

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

Default: 25

pagenumberOptional

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

Default: 1

Responses

200

Array of listing objects.

application/json

get

GET /api/getContractBids HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*

200

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

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.

limitnumberOptional

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

Default: 25

pagenumberOptional

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

Default: 1

Responses

200

Array of token objects.

application/json

get

GET /api/getContractTokens HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*

200

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
}

get

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

Authorizations

Query parameters

chainstringOptional

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

Default: eth

pagenumberOptional

The page of the results, used for pagination.

Default: 1

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

200

Array of collection objects.

application/json

get

GET /api/getUpcomingDrops HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*

200

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

get

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

Authorizations

Query parameters

chainstringOptional

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

Default: eth

post_idsstringOptional

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

Responses

200

Array of post_id to contract_address objects.

application/json

get

GET /api/getUpcomingDropsContracts HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*

200

Array of post_id to contract_address objects.

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

get

Returns a list of upcoming collections.

Authorizations

Query parameters

walletstringOptional

The wallet address.

chainstringOptional

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

Default: eth

pagenumberOptional

The page number, used for pagination.

Default: 1

limitnumberOptional

The limit of the response. Max is 50

Default: 50

Responses

200

Array of token objects.

application/json

get

GET /api/getWalletTokens HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*

200

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

get

Returns blockchain activity for the last 100 blocks.

Authorizations

Query parameters

typestringOptional

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

Default: all

pagenumberOptional

The page number, used for pagination.

Default: 1

limitnumberOptional

The limit of the response. Max is 100

Default: 50

Responses

200

Array of transaction objects.

application/json

get

GET /api/getChainActivity HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*

200

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

get

Returns a list of upcoming collections.

Authorizations

Query parameters

chainstringOptional

The chain of the upcoming drops.

Default: eth

pagenumberOptional

The page of the results, used for pagination.

Default: 1

categorystringOptional

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

Responses

200

Array of collection objects.

application/json

get

GET /api/getUpcomingCollections HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*

200

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

get

Returns an upcoming collection.

Authorizations

Query parameters

chainstringOptional

The chain of the upcoming drops.

Default: eth

idstringOptional

The id of the upcoming collection.

Responses

200

Array of post_id to contract_address objects.

application/json

get

GET /api/getUpcomingCollection HTTP/1.1
Host: api.mintify.xyz
API-KEY: YOUR_API_KEY
Accept: */*

200

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