Description

Returns the floor prices of an NFT contract by marketplace.

Parameters

Response

GetFloorPriceResponse object properties

FloorPriceError object properties

If there is an error, the failing object is returned by the getFloorPrice method call for each marketplace (e.g., looksRare, or OpenSea).

Example Request and Response

Prerequisite: You must install the Alchemy SDK before making requests with it.

The commands for installing it using npm or yarn are given below:

$
npm install alchemy-sdk@latest

Request

1
// Imports the Alchemy SDK
2
const { Alchemy, Network } = require("alchemy-sdk");
3
4
// Configures the Alchemy SDK
5
const config = {
6
    apiKey: "alchemy-replit", // Replace with your API key
7
    network: Network.ETH_MAINNET, // Replace with your network
8
};
9
10
// Creates an Alchemy object instance with the config to use for making requests
11
const alchemy = new Alchemy(config);
12
13
const main = async () => {
14
    // define the contract address
15
    const address = "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D";
16
17
    //Call the method to check the contract floor price
18
    const response = await alchemy.nft.getFloorPrice(address)
19
20
    //Logging the response to the console
21
    console.log(response)
22
}
23
24
main();

Response

1
{
2
    "openSea": {
3
        "floorPrice": 24.979951,
4
        "priceCurrency": "ETH",
5
        "collectionUrl": "https://opensea.io/collection/boredapeyachtclub",
6
        "retrievedAt": "2023-09-21T15:22:06.168Z",
7
        "error": undefined
8
    },
9
    "looksRare": {
10
        "floorPrice": 24.98,
11
        "priceCurrency": "ETH",
12
        "collectionUrl": "https://looksrare.org/collections/0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
13
        "retrievedAt": "2023-09-21T15:22:06.097Z",
14
        "error": undefined
15
    }
16
}

Use Cases

Here are some potential use cases for the getFloorPrice method:

• NFT marketplaces: In an NFT marketplace, the getFloorPrice method can be used to display the minimum price at which an NFT can be purchased. This helps buyers to determine the minimum price they need to pay for a particular NFT, and also helps sellers to set a minimum price for their NFT.

• Auctions: In an auction, the getFloorPrice method can be used to determine the minimum bid amount for an item. This helps to ensure that the auction starts at a fair price and helps to prevent low-ball bids.

• Automated market makers (AMMs): In an AMM, the getFloorPrice method can be used to determine the minimum price at which a particular token can be bought or sold. This helps to ensure that trades are executed at a fair price and helps to prevent price manipulation.

• Tokenized real estate: In the emerging market of tokenized real estate, the getFloorPrice method can be used to display the minimum price at which a particular real estate asset can be sold. This helps buyers to determine the minimum price they need to pay for a particular property, and also helps sellers to set a minimum price for their property.