docs / magiceden

Magic Eden API

base /magiceden/v113 endpoints

post/magiceden/v1/collections1 credit

Browse Magic Eden collections (paginated). Each: symbol, name, description, image, categories and social links. Use the returned symbol with the other actions. Offset pagination via the `page` param.

Parameter		Allowed / range	Description
page = 1	optional	1–500	Page number (1-based). Pages of `limit` items each; pass page=2 for the next page. Use meta.has_more to know when to stop.
limit = 20	optional	20–100	Items per page (snapped to a multiple of 20; 20-100, default 20).

Try in playground →

post/magiceden/v1/collection1 credit

Full collection detail by symbol: metadata (name, description, image, categories, social links) merged with live market stats — floor price (SOL), listed count, 24h average sale price and all-time volume.

Parameter		Allowed / range	Description
symbol	required	—	Magic Eden collection symbol — the last path segment of a Magic Eden collection URL (magiceden.io/marketplace/<symbol>), e.g. 'okay_bears', 'famous_fox_federation', 'degods'. Use the search or collections action to resolve a name to its symbol.

Try in playground →

post/magiceden/v1/stats1 credit

Live market stats for a collection: floor price (SOL), number of NFTs currently listed, 24-hour average sale price and all-time trading volume.

Parameter		Allowed / range	Description
symbol	required	—	Magic Eden collection symbol — the last path segment of a Magic Eden collection URL (magiceden.io/marketplace/<symbol>), e.g. 'okay_bears', 'famous_fox_federation', 'degods'. Use the search or collections action to resolve a name to its symbol.

Try in playground →

post/magiceden/v1/listings1 credit

Active NFT listings in a collection (NFTs currently for sale), cheapest first. Each: token mint, name, price (SOL), seller, rarity rank (Moonrank + HowRare), image and traits. Optional min/max price filter (SOL). Offset pagination via `page`.

Parameter		Allowed / range	Description
symbol	required	—	Magic Eden collection symbol — the last path segment of a Magic Eden collection URL (magiceden.io/marketplace/<symbol>), e.g. 'okay_bears', 'famous_fox_federation', 'degods'. Use the search or collections action to resolve a name to its symbol.
page = 1	optional	1–500	Page number (1-based). Pages of `limit` items each; pass page=2 for the next page. Use meta.has_more to know when to stop.
limit = 20	optional	20–100	Items per page (snapped to a multiple of 20; 20-100, default 20).
min_price	optional	0–	Only listings priced at or above this many SOL (must be > 0).
max_price	optional	0–	Only listings priced at or below this many SOL.

Try in playground →

post/magiceden/v1/tokens1 credit

All tokens (NFTs) in a collection (listed or not), paginated. Each: mint address, name, owner, image, list status, price if listed, and traits. Offset pagination via `page`.

Parameter		Allowed / range	Description
symbol	required	—	Magic Eden collection symbol — the last path segment of a Magic Eden collection URL (magiceden.io/marketplace/<symbol>), e.g. 'okay_bears', 'famous_fox_federation', 'degods'. Use the search or collections action to resolve a name to its symbol.
page = 1	optional	1–500	Page number (1-based). Pages of `limit` items each; pass page=2 for the next page. Use meta.has_more to know when to stop.
limit = 20	optional	20–100	Items per page (snapped to a multiple of 20; 20-100, default 20).

Try in playground →

post/magiceden/v1/token1 credit

Single NFT / token detail by its Solana mint address: name, collection, current owner, image, all traits, list status and price if listed. Get a mint address from a listings[], tokens[] or activity[] row.

Parameter		Allowed / range	Description
mint_address	required	—	The NFT's Solana mint address. From a listings[]/tokens[]/activity[] row (token_mint / mint_address).

Try in playground →

post/magiceden/v1/token_activity1 credit

On-chain activity history for a single NFT by mint address: every sale, listing, delisting and bid with type, price (SOL), buyer / seller and block time. Offset pagination via `page`.

Parameter		Allowed / range	Description
mint_address	required	—	The NFT's Solana mint address.
page = 1	optional	1–500	Page number (1-based). Pages of `limit` items each; pass page=2 for the next page. Use meta.has_more to know when to stop.
limit = 20	optional	20–100	Items per page (snapped to a multiple of 20; 20-100, default 20).

Try in playground →

post/magiceden/v1/activity1 credit

Recent on-chain activity for a collection: sales, listings, delistings and bids. Each event: type, price (SOL), buyer / seller, token mint and block time. Filter by event type (default: all). Offset pagination via `page`.

Parameter		Allowed / range	Description
symbol	required	—	Magic Eden collection symbol — the last path segment of a Magic Eden collection URL (magiceden.io/marketplace/<symbol>), e.g. 'okay_bears', 'famous_fox_federation', 'degods'. Use the search or collections action to resolve a name to its symbol.
page = 1	optional	1–500	Page number (1-based). Pages of `limit` items each; pass page=2 for the next page. Use meta.has_more to know when to stop.
limit = 20	optional	20–100	Items per page (snapped to a multiple of 20; 20-100, default 20).
event_type	optional	buyNow · list · delist · bid · cancelBid · auctionUpdate · placeBid	Filter to one activity type (omit for all).

Try in playground →

post/magiceden/v1/attributes1 credit

Trait floor prices for a collection — for every trait value (e.g. Background = Yellow), the floor price (SOL) and how many NFTs carry it. Useful for trait-based valuation.

Parameter		Allowed / range	Description
symbol	required	—	Magic Eden collection symbol — the last path segment of a Magic Eden collection URL (magiceden.io/marketplace/<symbol>), e.g. 'okay_bears', 'famous_fox_federation', 'degods'. Use the search or collections action to resolve a name to its symbol.

Try in playground →

post/magiceden/v1/wallet1 credit

NFTs held by a Solana wallet address: each token's mint, name, collection, image, list status and price if listed. Offset pagination via `page`.

Parameter		Allowed / range	Description
address	required	—	The Solana wallet address to list NFT holdings for.
page = 1	optional	1–500	Page number (1-based). Pages of `limit` items each; pass page=2 for the next page. Use meta.has_more to know when to stop.
limit = 20	optional	20–100	Items per page (snapped to a multiple of 20; 20-100, default 20).

Try in playground →

post/magiceden/v1/popular1 credit

Popular / trending Magic Eden collections over a time window — the marketplace leaderboard. Each: symbol, name, floor price (SOL) and all-time volume. Choose a window (1h / 1d / 7d / 30d).

Parameter		Allowed / range	Description
time_range = 1d	optional	1h · 1d · 7d · 30d	Ranking window (1h / 1d / 7d / 30d).
limit = 50	optional	50 · 100	Number of collections (Magic Eden allows 50 or 100).

Try in playground →

post/magiceden/v1/launchpad1 credit

Magic Eden Launchpad collections — upcoming and live primary mints. Each: symbol, name, mint price (SOL), supply size, launch datetime, chain and contract. Offset pagination via `page`.

Parameter		Allowed / range	Description
page = 1	optional	1–500	Page number (1-based). Pages of `limit` items each; pass page=2 for the next page. Use meta.has_more to know when to stop.
limit = 20	optional	20–100	Items per page (snapped to a multiple of 20; 20-100, default 20).

Try in playground →

post/magiceden/v1/search2 credits

Search Magic Eden collections by free-text name. Resolves a name to its collection symbol(s): first tries an exact symbol match, then scans popular collections and collection pages for a name/symbol substring match. Returns matching collections (symbol, name, image, categories) — use the returned symbol with the other actions.

Parameter		Allowed / range	Description
query	required	—	Collection name or keyword to search for (e.g. 'bears', 'fox', 'degods').
limit = 10	optional	1–50	Max collections to return (1-50, default 10).

Try in playground →

Example request · collections

curl -X POST https://api.reefapi.com/magiceden/v1/collections \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"limit":20}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}