---

🖼️ NFT Floor Price & Volume Tracker v3 — CoinGecko, Magic Eden, NFTPriceFloor

Track real‑time floor prices, 24h volumes, market caps, and supply for top NFT collections.
Fetches data from CoinGecko (free API with rate‑limit protection), Magic Eden (Solana), and NFTPriceFloor (HTML scraping). No API keys required. Perfect for investors, analysts, and NFT market researchers.

---

💡 What is the NFT Floor Price & Volume Tracker v3?

This actor collects real‑time NFT market data from multiple free public sources, avoiding expensive APIs or premium keys. It handles:

• CoinGecko – Uses /nfts/list then individual /nfts/{id} calls with a 2‑second delay to respect free tier limits. Stops gracefully on 429 (rate limit) without retrying.
• Magic Eden – Free public API for Solana NFT collections (floor price, volume, owners, supply).
• NFTPriceFloor.com – HTML scraping (including __NEXT_DATA__ JSON) for Ethereum collections.

The output includes floor price (native and USD), 24h volume, market cap, total supply, owners, contract address, image URL, and more. You can filter by keyword, blockchain, minimum floor price, and sort by volume, floor price, or market cap.

---

📦 What Data Can You Extract?

🧩 Data Type	📋 Description
🏷️ Collection Name	NFT collection name (e.g., “Bored Ape Yacht Club”).
🔗 Slug / Symbol	Unique identifier (CoinGecko ID or Magic Eden symbol).
📝 Contract Address	Smart contract address (when available).
⛓️ Blockchain	Ethereum, Solana, or other (detected from source).
💰 Floor Price	In native currency (ETH, SOL) and USD.
📊 24h Volume	Trading volume (native and USD).
📈 Market Cap	USD market cap (if available).
👥 Owners / Holders	Number of unique addresses owning the collection.
🏷️ Total Supply	Total number of NFTs in the collection.
📦 Listed Count	Number of items currently listed (Magic Eden).
🖼️ Image URL	Thumbnail or logo image.
📝 Description	Collection description (truncated).
🔗 Source URLs	Direct links to CoinGecko, Magic Eden, or NFTPriceFloor.
⏱️ Fetched At	ISO timestamp.

---

⚙️ Key Features

• No API Keys – All sources are free and public.
• Rate‑Limit Protection – CoinGecko calls are spaced 2 seconds apart; stops gracefully on 429.
• Multi‑Source – Ethereum (CoinGecko + NFTPriceFloor), Solana (Magic Eden).
• Flexible Filtering – By keyword, blockchain, minimum floor price.
• Sorting – By volume, floor price, or market cap.
• Deduplication – Removes duplicate collections across sources.
• Residential Proxy Ready – Optional but useful for HTML scraping.
• Clean JSON Output – Ready for Excel, SQL, or dashboards.

---

📥 Input Parameters

The actor accepts a JSON object with the following fields:

Parameter	Type	Required	Default	Description
keyword	string	No	–	Filter collections by name (case‑insensitive).
blockchain	string	No	"all"	all, ethereum, solana.
sort_by	string	No	"volume"	volume, floor, market_cap.
sources	array or string	No	["coingecko","nftpricefloor"]	coingecko, magiceden, nftpricefloor.
max_results	integer	No	20	Maximum number of collections to return.
min_floor	float	No	0	Minimum floor price in native currency (ETH/SOL).
proxyConfiguration	object	No	–	Apify proxy configuration (optional).

Example Input (Ethereum, high floor)

{
  "keyword": "bayc",
  "blockchain": "ethereum",
  "sort_by": "floor",
  "sources": ["coingecko", "nftpricefloor"],
  "max_results": 10,
  "min_floor": 10,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Example Input (Solana only)

{
  "blockchain": "solana",
  "sources": ["magiceden"],
  "max_results": 15
}

---

📤 Output Fields

Each NFT collection returns an object. Fields vary slightly by source but are standardised where possible.

Field	Type	Description
collection_name	string	Name of the NFT collection.
slug	string	Unique identifier (CoinGecko ID or Magic Eden symbol).
symbol	string	Ticker symbol (if available).
contract_address	string	Smart contract address (if available).
blockchain	string	Ethereum, Solana, etc.
floor_price_native	float	Floor price in native currency (ETH, SOL).
floor_price_usd	float	Floor price in USD (if available).
floor_price_currency	string	Currency symbol (ETH, SOL).
volume_24h_native	float	24‑hour trading volume in native currency.
volume_24h_usd	float	24‑hour volume in USD.
volume_7d_native	float	7‑day volume (NFTPriceFloor only).
market_cap_usd	float	Market cap in USD (if available).
owners	integer	Number of unique owners/holders.
total_supply	integer	Total number of NFTs in collection.
listed_count	integer	Number listed for sale (Magic Eden).
image_url	string	Thumbnail/logo URL.
description	string	Short description (if available).
coingecko_url	string	CoinGecko NFT page (CoinGecko only).
magic_eden_url	string	Magic Eden marketplace link (Magic Eden only).
nftpricefloor_url	string	NFTPriceFloor page (NFTPriceFloor only).
source	string	CoinGecko, Magic Eden, NFTPriceFloor.
fetched_at	string	ISO 8601 timestamp.

Example Output (CoinGecko)

[
  {
    "collection_name": "Bored Ape Yacht Club",
    "slug": "bored-ape-yacht-club",
    "symbol": "BAYC",
    "contract_address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
    "blockchain": "Ethereum",
    "floor_price_native": 14.2,
    "floor_price_usd": 25600.5,
    "floor_price_currency": "ETH",
    "volume_24h_native": 850.3,
    "volume_24h_usd": 1532000,
    "market_cap_usd": 1024000000,
    "owners": 5800,
    "total_supply": 10000,
    "image_url": "https://assets.coingecko.com/nft/images/...",
    "description": "Bored Ape Yacht Club is a collection of 10,000 unique NFTs...",
    "coingecko_url": "https://www.coingecko.com/en/nft/bored-ape-yacht-club",
    "source": "CoinGecko",
    "fetched_at": "2026-04-12T12:00:00Z"
  }
]

---

🛠 How to Use on Apify

1. Create a task with this actor.
2. Select sources – CoinGecko (Ethereum), NFTPriceFloor (Ethereum), Magic Eden (Solana).
3. Add filters – keyword, blockchain, min floor, sorting.
4. Configure proxy – optional (CoinGecko API rarely needs it; HTML scrapers may benefit from residential proxies).
5. Run – the actor collects data from chosen sources.
6. Export – download results as JSON, CSV, or Excel.

Running via API

curl -X POST "https://api.apify.com/v2/acts/your-username~nft-floor-price-tracker/runs" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
    "keyword": "bayc",
    "blockchain": "ethereum",
    "max_results": 5
  }'

---

🎯 Use Cases

• NFT Portfolio Tracking – Monitor floor prices of collections you own.
• Market Research – Analyse top collections by volume, floor price, or market cap.
• Investment Decisions – Identify undervalued collections based on floor price vs volume.
• Solana NFT Analysis – Use Magic Eden API to track Solana collections.
• Data Aggregation – Build your own NFT dashboard or alert system.

---

❓ Frequently Asked Questions

Q1. Do I need an API key for CoinGecko?

No. The actor uses the free public API. The free tier allows ~30 calls per minute; the actor respects this with a 2‑second delay between calls.

Q2. Why do I see “rate limited” in logs?

CoinGecko free tier may throttle you if you exceed ~50 calls per minute. The actor stops gracefully and returns whatever it collected so far. Increase delays or use a paid CoinGecko API key (not supported in this actor).

Q3. Does Magic Eden require an API key?

No. Magic Eden provides a free public API.

Q4. Can I get USD values for Solana collections?

Magic Eden returns floor price in SOL only. The actor does not automatically convert to USD. You can use an external price feed.

Q5. How fresh is the data?

• CoinGecko: Updates every few minutes.
• Magic Eden: Near real‑time.
• NFTPriceFloor: Updates daily.

Q6. Why are some fields missing?

Not all sources provide every field (e.g., NFTPriceFloor often lacks market cap). The actor returns what is available.

Q7. What does min_floor filter?

It filters by floor_price_native (ETH or SOL). For example, min_floor: 10 returns only collections with floor price ≥ 10 ETH (or SOL).

Q8. Can I add other sources (e.g., OpenSea)?

This version supports CoinGecko, Magic Eden, and NFTPriceFloor. You can extend the script for OpenSea API (requires API key).

---

📝 Technical Notes

• Dependencies: curl_cffi (for TLS fingerprint spoofing) and BeautifulSoup4. Both are bundled.
• CoinGecko rate‑limit handling: The actor calls /nfts/list once, then iterates over matching items, calling /nfts/{id} with time.sleep(2) between calls. If a 429 response is received, the loop breaks immediately.
• Magic Eden API: Uses https://api-mainnet.magiceden.dev/v2/marketplace/popular_collections with pagination.
• NFTPriceFloor: Extracts __NEXT_DATA__ JSON first; falls back to HTML table scraping.
• Proxy: Not required for CoinGecko API, but can be used for NFTPriceFloor HTML scraping to avoid IP‑based rate limiting.

---

🔍 SEO Keywords

NFT floor price tracker, NFT volume data, CoinGecko NFT API, Magic Eden scraper, Solana NFT floor price, Ethereum NFT market cap, NFTPriceFloor scraper, crypto art intelligence, Apify NFT actor, NFT collection analytics

---