# Magic Eden Solana NFT Collection & Floor Price Scraper (`scrapers_lat/magiceden-nft-collections-scraper`) Actor

Solana NFT market intelligence from Magic Eden: floor price, volume, listed counts, collection metadata and socials, plus optional live listings and an AI market summary. Batch by symbol or search. Keyless, HTTP-only.

- **URL**: https://apify.com/scrapers\_lat/magiceden-nft-collections-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** AI, Developer tools, E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $12.48 / 1,000 collection market intelligence results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

[![Magic Eden Solana NFT Collection & Floor Price Scraper](https://scrapers.lat/banners/magiceden-nft-collections-scraper.png)](https://apify.com/scrapers_lat/magiceden-nft-collections-scraper)

## Magic Eden Solana NFT Collection & Floor Price Scraper

Turn any list of Magic Eden collection symbols (or a search query) into clean, structured Solana NFT market intelligence: floor price, trading volume, listed counts, average sale price, collection metadata and socials, plus optional live listings and an AI market summary. Built for NFT traders, analysts, and market researchers who need current floor and liquidity data in one call.

Here is one real result, with the core fields the actor returns for a collection:

```json
{
  "recordType": "collection",
  "symbol": "mad_lads",
  "name": "Mad Lads",
  "description": null,
  "image": null,
  "website": null,
  "twitter": null,
  "discord": null,
  "categories": [],
  "floorPriceSol": 7.24999,
  "floorPriceLamports": "7249990000",
  "listedCount": 239,
  "avgPrice24hrSol": 7.431479,
  "volumeAllSol": null,
  "volume7dSol": 485.654377,
  "metadataAvailable": false,
  "aiMarketSummary": {
    "summary": "The Mad Lads collection is currently experiencing a stable floor price of 7.25 SOL, with a 24-hour average sale price slightly higher at 7.43 SOL, indicating consistent buyer interest. With 239 listings, there is notable selling pressure that could impact future price movements.",
    "sentiment": "neutral",
    "tags": ["Mad Lads", "NFT", "market analysis"]
  },
  "observedAt": "2026-08-16T16:40:00.000Z",
  "error": null
}
```

Give it one symbol or hundreds. Every collection returns one row with lamport values decoded into clean SOL numbers (and the raw lamports kept for precision), so you can filter, rank, and chart floor prices and volume immediately. This complements the scrapers.lat Solana Wallet Intelligence scraper for a complete Solana market-and-holder view.

> Note on metadata: Magic Eden aggressively rate-limits its keyless collection metadata route, so socials and description (`metadataAvailable`) are returned on a best-effort basis. The core market stats (floor, volume, listed count, average price) and live listings are always returned, and the collection name and image are backfilled from listing data when the metadata route is unavailable.

### Input

| Field | Type | Description |
| --- | --- | --- |
| `symbols` | array | Magic Eden collection symbols (the slug in the collection URL, for example `mad_lads`, `okay_bears`). |
| `symbol` | string | A single collection symbol. Use `symbols` for multiple. |
| `search` | string | Optional. Discover collections whose name or symbol contains this text (matched against the Magic Eden collection list). |
| `includeListings` | boolean | Emit one row per active listing per collection (paid add-on, off by default). |
| `maxListings` | integer | Cap listings emitted per collection (default 20). |
| `withAiSummary` | boolean | Add an AI market-health and sentiment note per collection (paid add-on, off by default). |
| `maxCollections` | integer | Maximum collections per run. Free Apify accounts are capped at 10 per run. |
| `proxyConfiguration` | object | Proxy settings. Defaults to Apify Residential for reliable, un-throttled results. |

### Output

| Field | Description |
| --- | --- |
| `symbol` | Magic Eden collection symbol (slug). |
| `name` | Collection display name. |
| `description`, `image`, `website`, `twitter`, `discord`, `categories` | Collection metadata and socials (best-effort; see note above). |
| `floorPriceSol` / `floorPriceLamports` | Current floor price in SOL and raw lamports. |
| `listedCount` | NFTs currently listed for sale. |
| `avgPrice24hrSol` | Average sale price over the last 24 hours, in SOL. |
| `volumeAllSol` / `volume7dSol` | All-time and 7-day trading volume, in SOL. |
| `metadataAvailable` | Whether the metadata/socials route was reachable this run. |
| `aiMarketSummary` | Optional AI market note `{summary, sentiment, tags}` when the AI add-on is on. |
| `observedAt` | When the record was collected (ISO). |
| `error` | Error message for unknown or invalid symbols (never billed). |

Listing rows (when `includeListings` is on) add: `tokenMint`, `tokenAddress`, `listingPda`, `priceSol`, `priceLamports`, `seller`, `rarityRank`.

### Use cases

- Track Solana NFT floor prices and volume across many collections for trading and portfolio dashboards.
- Build NFT market analytics: floor trends, liquidity, listing pressure, and 24h average price.
- Monitor floor and listed counts to time entries and exits on Magic Eden collections.
- Pull live listings with rarity ranks to snipe under-floor or rare NFTs.
- Research and compare Solana NFT collections by name via search.
- Feed structured NFT market data into alerting bots, spreadsheets, and BI tools.
- Generate quick AI market-health and sentiment summaries for buyer-facing reports.

### Billing

This actor uses pay-per-event pricing and never charges on failure (unknown or invalid symbols return an unbilled error row):

- **Collection market intelligence result** ($0.012): charged once per collection record returned.
- **Live listings add-on** ($0.008): charged once per collection whose active listings were successfully fetched, only when `includeListings` is on and the fetch returns listings.
- **AI market summary add-on** ($0.012): charged once per collection, only when the AI add-on is on and a usable summary is produced.

Both add-ons are disabled for free Apify accounts, and free accounts are capped at 10 collections per run.

# Actor input Schema

## `symbols` (type: `array`):

A list of Magic Eden collection symbols (the slug in the collection URL, for example mad\_lads or okay\_bears). Each symbol returns one market-intelligence record.

## `symbol` (type: `string`):

A single Magic Eden collection symbol, for example mad\_lads. Use the Collection Symbols field for multiple.

## `search` (type: `string`):

Optional. Instead of exact symbols, discover collections whose name or symbol contains this text (matched client-side against the Magic Eden collection list). Combine with Max Collections to cap results.

## `includeListings` (type: `boolean`):

When on, also emit one row per active listing for each collection (token mint, price in SOL, seller, rarity rank, listing PDA). Charged as a data add-on, once per collection with a non-empty listings fetch. Disabled for free Apify accounts.

## `maxListings` (type: `integer`):

Cap the number of active listings emitted per collection when the listings add-on is enabled.

## `withAiSummary` (type: `boolean`):

When on, use AI to turn each collection's floor price, volume and listing pressure into a concise buyer-facing market-health and sentiment note (liquidity, momentum, listing pressure). Billed only when a usable summary is produced. Disabled for free Apify accounts.

## `maxCollections` (type: `integer`):

Maximum number of collections to process in this run. Free Apify accounts are capped at 10 per run.

## `proxyConfiguration` (type: `object`):

Proxy settings. Magic Eden rate-limits single IPs, so the actor uses Apify Residential proxy by default (fresh IP per request) for reliable results. You may override or disable it here.

## Actor input object example

```json
{
  "symbols": [
    "mad_lads"
  ],
  "includeListings": false,
  "maxListings": 20,
  "withAiSummary": false,
  "maxCollections": 100,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "symbols": [
        "mad_lads"
    ],
    "maxCollections": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/magiceden-nft-collections-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "symbols": ["mad_lads"],
    "maxCollections": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/magiceden-nft-collections-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "symbols": [
    "mad_lads"
  ],
  "maxCollections": 100
}' |
apify call scrapers_lat/magiceden-nft-collections-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapers_lat/magiceden-nft-collections-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/dQ49thiaSoE40Pvv7/builds/TazFNF6i6OxLcp1tC/openapi.json