Links

nft_floorPrice

Gets an NFT listing's floor price for a given marketplace.
Through nft_floorPrice, you can acknowledge the floor price of specific NFT, listing market and price currency species, contractAddress and tokenId are necessary. Using this API, you could do some buying investigations and decisions by search for the floor price. Also, some marketing strategies could be made by calling this API.
Supported on Ethereum.

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.
  • tokenId(string, required) - id of the NFT.

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:
    • price(string) - the floor price of the NFT.
    • currency(string) - the currency of the order.
    • marketplace(string) - the floor price listing market.
    • retrievedAt(integer number) - the corresponding timestamp when the data is retrieved.

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_floorPrice",
"params": {
"contractAddress": "0x1792a96E5668ad7C167ab804a100ce42395Ce54D",
"tokenId": "2208"
}
}'
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.getNFTFloorPrice({
contractAddress: '0x1792a96E5668ad7C167ab804a100ce42395Ce54D',
tokenId: '2208'
}).then(console.log)

Result

{
"jsonrpc": "2.0",
"id": 1,
"result": {
"data": {
"price": "1.95",
"currency": "Wrapped Ether",
"marketplace": "looksRare",
"retrievedAt": 1658386178
}
}
}