# Magic Eden API
> Live Solana NFT-marketplace data from Magic Eden, the largest NFT marketplace on Solana — a marketplace order-book and trade-feed layer, not a floor-price aggregator: live collection market stats (floor price in SOL, listed count, 24h average sale price, all-time volume), the live order book of tokens on sale (SOL ask price, seller, token mint, rarity rank) and the live trade feed (buys, listings, bids, delistings with price, buyer, seller, on-chain signature and time).

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/magiceden-api/..."
```

## Pricing
- **Free** (Free) — 8,000 calls/Mo, 2 req/s
- **Basic** ($8/Mo) — 130,000 calls/Mo, 5 req/s
- **Pro** ($24/Mo) — 850,000 calls/Mo, 10 req/s
- **Scale** ($58/Mo) — 4,500,000 calls/Mo, 25 req/s

## Endpoints

### Market

#### `GET /v1/stats` — Live collection market stats

**Parameters:**
- `symbol` (query, required, string) — Magic Eden collection symbol Example: `okay_bears`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/magiceden-api/v1/stats?symbol=okay_bears"
```

**Response:**
```json
{
    "data": {
        "source": "Magic Eden",
        "symbol": "okay_bears",
        "listed_count": 707,
        "volume_all_sol": 3479703.62726,
        "floor_price_sol": 1.6443,
        "avg_price_24hr_sol": 1.852858
    },
    "meta": {
        "timestamp": "2026-06-10T14:01:47.501Z",
        "request_id": "6056eef3-9bf5-4b2d-adce-86048ac71516"
    },
    "status": "ok",
    "message": "Stats retrieved successfully",
    "success": true
}
```

### Marketplace

#### `GET /v1/listings` — Live order book of tokens on sale

**Parameters:**
- `symbol` (query, required, string) — Magic Eden collection symbol Example: `okay_bears`
- `limit` (query, optional, string) — Results, multiple of 20 (max 100) Example: `20`
- `offset` (query, optional, string) — Offset, multiple of limit Example: `0`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/magiceden-api/v1/listings?symbol=okay_bears&limit=20&offset=0"
```

**Response:**
```json
{
    "data": {
        "count": 20,
        "limit": 20,
        "offset": 0,
        "source": "Magic Eden",
        "symbol": "okay_bears",
        "listings": [
            {
                "seller": "HNSERyK1yKQrdp3GWCXNogdALqmJviKeuWMZyeyh1Jrs",
                "price_sol": 1.6443,
                "token_mint": "AwsftwacmNavwSd59bekD2ty6fip8w24BPAVF6K6gcq7",
                "token_size": 1,
                "rarity_rank": 6601,
                "auction_house": "E8cU1WiRWjanGxmn96ewBgk9vPTcL6AEZ1t6F6fkgUWe",
                "token_address": "3bpMmrSvCZQRqYrpwNkTdWMnba1kDmpMkpAkWW2EEPs2"
            },
            {
                "seller": "7zcRWrKMimPowkEnvqw7q3RznLSGieKFCoM4wNmxyUg4",
                "price_sol": 1.64431,
                "token_mint": "GU6pHuFeT4d6qf9TZzf6JVkcKArV5NNC4gPfqPJLXMrk",
                "token_size": 1,
                "rarity_rank": 4364,
                "auction_house": "E8cU1WiRWjanGxmn96ewBgk9vPTcL6AEZ1t6F6fkgUWe",
                "token_address": "Ff8zWpVDk1ECB4RMFjCiGhyTdsN6QJ7HNFbETvPAE6K5"
            },
            {
                "seller": "HNSERyK1yKQrdp3GWCXNogdALqmJviKeuWMZyeyh1Jrs",
                "price_sol": 1.69999,
                "token_mint": "GayrNcKgarxqayzNDfo3RnaBBC3AC4BbmcngTpGk2wRf",
                "token_size": 1,
                "rarity_rank": 8202,
                "auction_house": "E8cU1WiRWjanGxmn96ewBgk9vPTcL6AEZ1t6F6fkgUWe",
                "token_address": "22pyMFpJbKgfqWJZXSUR8dwv1ytyriwbmnQdT1qPpANP"
 
…(truncated, see openapi.json for full schema)
```

### Activity

#### `GET /v1/activities` — Live trade feed: buys, lists, bids, delists

**Parameters:**
- `symbol` (query, required, string) — Magic Eden collection symbol Example: `okay_bears`
- `limit` (query, optional, string) — Results, multiple of 20 (max 100) Example: `20`
- `offset` (query, optional, string) — Offset, multiple of limit Example: `0`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/magiceden-api/v1/activities?symbol=okay_bears&limit=20&offset=0"
```

**Response:**
```json
{
    "data": {
        "count": 20,
        "limit": 20,
        "offset": 0,
        "source": "Magic Eden",
        "symbol": "okay_bears",
        "activities": [
            {
                "slot": 425559667,
                "time": "2026-06-10T14:01:12.000Z",
                "type": "list",
                "buyer": null,
                "seller": "CPCNxyd5HJis25XDuMcdzS8PrG7LXQsGGEC3pDDFj7mJ",
                "source": "magiceden_v2",
                "price_sol": 2.0989,
                "signature": "5wZQ2X5ryA8YPjP6Ri1N7CNxpZ6WZUXjSRy5i4LPuQxkyQBdmaUFKfiMA3DPsGnYBo8mqkcA5bbZ9gEEFXa4zwKb",
                "token_mint": "GGYqK5mGYHJCJxMib6cUepmcsBBDqTXYkTZprTAuFD5W"
            },
            {
                "slot": 425559020,
                "time": "2026-06-10T13:56:57.000Z",
                "type": "bid",
                "buyer": "HkHXGYDShwiApvpBeb8hPEktjejgKnUDgkmM1eipToZU",
                "seller": null,
                "source": "mmm",
                "price_sol": 2.5621,
                "signature": "4uToDG3uEBjgpDpHfx2hRoRvwHb6mMzawq2haRK4Qhtvbj6MHMQN13UGvLhv5cdos7M6DLBemUHJWdejdQWiKgry",
                "token_mint": null
            },
            {
                "slot": 425559020,
                "time": "2026-06-10T13:56:57.000Z",
                "type": "poolUpdate",
                "buyer": null,
                "seller": "HkHXGYDShwiApvpBeb8hPEktjejgKnUDgkmM1eipToZU",
                "source": "mmm",
                "price_sol": 2.5621,
           
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata and endpoint catalog

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/magiceden-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "Magic Eden mainnet API (api-mainnet.magiceden.dev, live)",
        "service": "magiceden-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/stats": "Live market stats: floor, listed count, 24h avg, all-time volume (symbol=okay_bears).",
            "GET /v1/listings": "The live order book of tokens on sale (symbol=okay_bears, offset, limit).",
            "GET /v1/activities": "The live trade feed: buys, lists, bids, delists (symbol=okay_bears, offset, limit)."
        },
        "description": "Live Solana NFT-marketplace data from Magic Eden, the largest NFT marketplace on Solana — a marketplace order-book and trade-feed layer, not a floor-price aggregator. The stats endpoint returns a collection's live market stats (floor price in SOL, listed count, 24h average sale price, all-time volume); the listings endpoint returns the live order book (tokens on sale with SOL ask price, seller, token mint and rarity rank); the activities endpoint returns the live trade feed (buys, listings, bids, delistings with price, buyer, seller, on-chain signature and time). Live, no key, nothing stored. Distinct from generic NFT floor/market-cap aggregators and from on-chain explorers — this is Magic Eden's own Solana marketplace listings and trade activity.",
        "upstream_status": "ok",
        "sample_floor_sol": 1.6443
    },
    "meta": {
        "timestamp": "2026-06-10T14:01:48.461Z",
        "request_
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/magiceden-api
OpenAPI spec: https://www.oanor.com/api/magiceden-api/openapi.json