- Market overviews and dashboards
- Collection comparisons
- Entry-price signals and alerts
What a Floor Price Represents
The floor price is the lowest active listing price for an NFT in a given collection. Important characteristics:- Based on active listings, not completed sales
- Represents seller intent, not executed market price
- Calculated at the collection level, not per token
Supported Chains
NFT floor prices are currently supported on:- Ethereum
- Base
- Monad
- Arbitrum
- Ronin
- Flow
- Sei
Data Sources
Floor prices are sourced from a combination of marketplace and aggregation APIs:- OpenSea API (primary source)
- Magic Eden API
Magic Eden aggregates floor prices across multiple marketplaces, including OpenSea, Blur, X2Y2, and Magic Eden itself - CoinGecko (fallback / enrichment)
- NFT Sale Prices → derived from onchain marketplace trades
- NFT Floor Prices → derived from offchain marketplace listing data
Refresh Frequency
Floor prices are refreshed every 60 minutes. This cadence balances:- Marketplace rate limits
- Data freshness
- Platform-wide performance and stability
First-Time Requests (Warm-Up Behavior)
If a collection’s floor price has never been requested before, the first request will return:- HTTP status: 202
-
Message:
- The collection is registered for tracking
- Floor price data begins syncing
Inactivity Handling
If a collection has no trading activity for 7 days:- Floor price updates are paused
- No new floor price snapshots are recorded
- Floor price updates automatically resume
- No manual action is required
Historical Floor Price Data
Backfilling
Historical floor prices are not backfilled. Reason:- Marketplace APIs do not currently expose historical listing data
- Historical tracking can only begin after the first request
Supported Historical Intervals
When requesting time-series floor price data, the interval determines the data resolution:- 1 day
Data points every 60 minutes - 7 days
Hourly data points - 30 days
Hourly data points - Greater than 30 days
Daily data points
Inactive Collections and Historical Access
If a collection becomes inactive:- Floor prices stop updating
- Previously saved historical data remains accessible
- Analyze past market conditions
- Build long-term charts
- Compare historical floors even for dormant collections
When to Use Floor Prices (and When Not To)
Use NFT Floor Prices when you need:- A quick market baseline
- Collection-to-collection comparisons
- Entry price signals
- Valuation of a specific NFT
- Profitability or realized value calculations
- Historical execution accuracy

