A floor price is the lowest currently listed price of an NFT for a given NFT (often specific to an NFT marketplace).
The SimpleHash API includes detail on the floor price of NFT collections on the following chains:
- Ethereum: Live
- Solana: Live
- Polygon: Live
- Arbitrum: Live
- Optimism: Live
- Avalanche: Live
- BSC: Live
Floor prices from the following marketplaces are included: OpenSea, X2Y2, LooksRare, and Magic Eden
Coverage of more chains and marketplaces will be added in the near future.
The floor prices array can be found on the field named floor_prices on the collection model on the "NFT by..." endpoints, and directly on the the Collections by Wallet endpoint.
floor_price model:
| Field | Description | Type(s) |
|---|---|---|
| marketplace_id | Unique identifier of the NFT marketplace associated with the floor price | string |
| value | The value of the floor price in the relevant currency | int |
| payment_token | Detail on the relevant currency | payment_token |
payment_token model:
| Field | Description | Type(s) |
|---|---|---|
| payment_token_id | Unique identifier of the token type relevant to the collection. Currently for ethereum ecosystem sales, this may be ethereum.native for the native ETH token, or ethereum.{contract_address} for ERC-20 tokens | string |
| name | Name of the token, e.g., Ether derived from the contract or otherwise | string / null |
| symbol | Symbol of the token derived from the contract or otherwise, e.g., ETH | string / null |
| address | Contract address of the ERC-20 token associated with the collection (null in the case of the native ETH token) | string / null |
| decimals | Base number of decimals of the token value associated with the collection (e.g., 18 in the case of the native ETH token) | int |