Links

nft_collectionMarketInfo

Get market information for an NFT collection.
Through nft_collectionMarketInfo, you can fetch the detailed market information of the specific NFT collection, contractAddress is necessary. The market information includes the number of holders, total volume, etc. Using this API, you could have a bird-eye view of the market information of the certain NFT collection. Some investigation and marketing strategies could be made by calling this API.
Supported on Ethereum and BNB Chain.

Parameters

Object - An object with the following fields (required):
  • contractAddress(hex string, required) - the contract address of the collection. BlockVision currently support both ERC721 and ERC1155.

Returns

Object - An object with the following fields:
  • id(integer number) - json-rpc id.
  • jsonrpc(string) - json-rpc version.
  • result(object) - an object with the following fields:
    • contractAddress(hex string) - contract address.
    • name(string) - collection name.
    • imageURL(string) - logo of the collection.
    • bannerImageURL(string) - background image of the collection.
    • floorPrice(string) - floor price of the collection.
    • description(string) - description of the collection.
    • items(integer number) - the number of NFT already in circulation in the market.
    • owners(integer number) - the number of owners of the collection.
    • lowestPriceIn24H(string) - lowest price in 24 hour.
    • averagePriceIn24H(string) - average price in 24 hour.
    • tradeVolumeIn24H(string) - trade volume in 24 hour.
    • salesIn24H(string) - the number of NFT sold in 24 hour.
    • highestPrice(string) - the highest price of NFT in history.
    • totalVolume(string) - total volume of the collection.

Example

Request

curl
TypeScript
curl https://api.blockvision.org/v1/<api key> \
-X POST \
-H "Content-Type: application/json" \
-d '{
"id": 1,
"jsonrpc": "2.0",
"method": "nft_collectionMarketInfo",
"params": {
"contractAddress": "0x6B31a2EF5986d283332E4A3a608aDB3C09fFdD13"
}
}'
import { BlockVisionProvider, BvNetwork } from 'blockvision.js'
​
// Optional parameters, but default to eth-mainnet and default api-key.
const bv = new BlockVisionProvider(BvNetwork.ETH_MAINNET)
​
// Access the BlockVision NFT API
bv.getNFTCollectionMarketInfo({
contractAddress: '0x6B31a2EF5986d283332E4A3a608aDB3C09fFdD13'
}).then(console.log)

Result

{
"jsonrpc": "2.0",
"id": 1,
"result": {
"contractAddress": "0x60E4d786628Fea6478F785A6d7e704777c86a7c6",
"name": "MutantApeYachtClub",
"imageURL": "https://lh3.googleusercontent.com/lHexKRMpw-aoSyB1WdFBff5yfANLReFxHzt1DOj_sg7mS14yARpuvYcUtsyyx-Nkpk6WTcUPFoG53VnLJezYi8hAs0OxNZwlw6Y-dmI=s120",
"description": "The MUTANT APE YACHT CLUB is a collection of up to 20,000 Mutant Apes that can only be created by exposing an existing Bored Ape to a vial of MUTANT SERUM or by minting a Mutant Ape in the public sale.",
"bannerImageURL": "https://lh3.googleusercontent.com/5c-HcdLMinTg3LvEwXYZYC-u5nN22Pn5ivTPYA4pVEsWJHU1rCobhUlHSFjZgCHPGSmcGMQGCrDCQU8BfSfygmL7Uol9MRQZt6-gqA=s2500",
"floorPrice": "11.29",
"items": 19427,
"owners": 12897,
"lowestPriceIn24H": "10.18",
"averagePriceIn24H": "11.159238561764704",
"tradedVolumeIn24H": "379.41411109999996",
"salesIn24H": "34",
"highestPrice": "350",
"totalVolume": "1402559.0627265302"
}
}