LogoLogo
WebsiteDiscordTwitter
  • Welcome
  • Changelog
  • MINT Token
  • Rewards
    • Swap Tourney
    • Rewards Overview
    • XP System Breakdown
    • Genesis Keys Overview
    • XP Boosts
    • SZN1 Mechanics
  • Other
    • Security & Audits
    • API (Programmatic Trading)
    • API (Data & Analytics)
    • Brand Assets
    • Press & Media
  • Legal
    • Terms of Use
    • Privacy Policy
Powered by GitBook
On this page
  1. Other

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

You can sign up for access to the Mintify API here:

To use our Blast API use this endpoint:

To use our Base API use this endpoint:

To use our ETH API use this endpoint:

To use our Ordinals API use this endpoint:

To use our Flow API use this endpoint:

To use our Apechain API use this endpoint:

To use our Abstract API use this endpoint:

To use our Berachain API use this endpoint:


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

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

https://learn.mintify.xyz/api
https://api-blast.mintify.xyz
https://api.mintify.xyz
https://api-ordinals.mintify.xyz
https://api-flow.mintify.xyz
https://api-apechain.mintify.xyz/
https://api-abstract.mintify.xyz
https://api-berachain.mintify.xyz
https://api-base.mintify.xyz
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"
}
  • GET/getActiveContracts
  • GET/getContract
  • GET/getContractDatapoints
  • GET/getContractFloorDatapoints
  • GET/getTrendingContracts
  • GET/getContractListings
  • GET/getContractActivity
  • GET/getContractBids
  • GET/getContractTokens
  • GET/getUpcomingDrops
  • GET/getUpcomingDropsContracts
  • GET/getWalletTokens
  • GET/getChainActivity
  • GET/getUpcomingCollections
  • GET/getUpcomingCollection