canonical: https://jentic.com/apis/magiceden.io/magiceden # Magic Eden API The Magic Eden API queries NFT marketplace data across multiple blockchains. It returns collections and their listings, trading activities, and floor and volume stats, resolves individual tokens by mint address with their listings and activities, and lists the tokens and activities held by a wallet. All operations are read-only and authenticated with a bearer token. ## For AI agents Query NFT collections, listings, trading activities, stats, token details, and wallet holdings on the Magic Eden marketplace. ## Scope Does not mint tokens, execute trades, or custody assets. Use for reading NFT collection, token, and wallet market data only. ## Capabilities - List NFT collections and get one by its symbol - Retrieve the active listings for a collection - Get floor price and volume stats for a collection - Read trading activities for a collection or a token - Look up a token by its mint address with its listings - List the tokens and activities held by a wallet address ## Use cases ### Answer NFT market questions for an AI agent An AI agent integration created through Jentic answers questions about NFT collections. The Magic Eden API returns a collection's floor and volume stats, its active listings, and its recent activities, so the agent can report the state of a collection across supported blockchains without scraping the marketplace. Example prompt: Get the stats and active listings for a collection by its symbol and summarize them ### Track a wallet's NFT holdings Portfolio tools need the NFTs a wallet holds and its recent moves. The Magic Eden API lists the tokens held by a wallet address and its activities, so an automation can build a holdings view and flag new acquisitions or sales for that wallet. Example prompt: List the tokens held by a wallet address and its recent activities ### Monitor a token's listings and activity Watching a single NFT requires its listing and trade history. The Magic Eden API resolves a token by its mint address and returns its listings and activities, so an agent can watch for a price change or a sale on a specific token and act on it. Example prompt: Look up a token by its mint address and return its current listings and activities ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/collections` | Get collections | | GET | `/collections/{symbol}` | Get a collection by symbol | | GET | `/collections/{symbol}/listings` | Get listings for a collection | | GET | `/collections/{symbol}/stats` | Get collection stats | | GET | `/collections/{symbol}/activities` | Get collection activities | | GET | `/tokens/{token_mint}` | Get a token by mint address | | GET | `/wallets/{wallet_address}/tokens` | Get tokens held by a wallet | ## Key resources - **Collections** — List collections and get one by symbol with its listings, activities, and stats - **Tokens** — Resolve a token by mint address with its listings and activities - **Wallets** — List the tokens and activities for a wallet address ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 59 / 100 - **Maturity:** Foundational - **Dimensions:** - Foundational Compliance: 100 / 100 - Developer Experience & Jentic Compatibility: 56 / 100 - AI-Readiness & Agent Experience: 40 / 100 - Agent Usability: 94 / 100 - Security: 60 / 100 - AI Discoverability: 50 / 100 - **View full report:** https://jentic.com/apis/magiceden.io/magiceden/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring the Magic Eden API by hand means handling its bearer token and paging through collection, token, and wallet queries yourself. Through Jentic you install once, import Magic Eden from the API Directory, store the token once, and your agent calls it. - **Permission scoping:** Magic Eden puts the collection symbol in the URL path, so a rule can limit your agent to reading one collection's listings, stats, and activities. Every operation is read-only, so you choose which market-data operations the agent may call and no write access exists to grant. - **Credential handling:** Your Magic Eden token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'get collection stats' or 'list a wallet's tokens', and Jentic returns the matching Magic Eden operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **Rarible** — Rarible exposes multi-chain NFT marketplace data and trading; Magic Eden returns collection, token, and wallet market data. - **Alchemy** — Alchemy provides low-level blockchain and NFT data APIs; pair it with Magic Eden for on-chain detail beyond marketplace listings. - **CoinGecko** — CoinGecko supplies crypto token prices and market data; pair it with Magic Eden to add fiat pricing context to NFT activity. ## FAQ ### What authentication does the Magic Eden API use? The Magic Eden API authenticates with a bearer token in the Authorization header, per its OpenAPI spec. Through Jentic the token is stored encrypted by your own Jentic One instance and injected at call time, so it never reaches the agent's prompt or logs. ### Can I get collection stats with the Magic Eden API? Yes. The collection stats operation returns floor price and volume for a collection by its symbol, and separate operations return its active listings and recent activities, so an agent can report a collection's current state. ### Can I see what NFTs a wallet holds with the Magic Eden API? Yes. The wallet operations list the tokens held by a wallet address and its recent activities, so an agent can build a holdings view and track acquisitions or sales for that wallet. ### How do I query NFT data through Jentic? Install Jentic One on your own infrastructure with `curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh`, then import the Magic Eden API from the API Directory and search for 'get NFT collection stats'. Store the token once and your agent can query collections, tokens, and wallets. To run it on your own infrastructure, install Jentic One from its GitHub repo. ### Is there a Magic Eden MCP server? You don't need an MCP server to give your agent the Magic Eden API. Jentic connects it directly from the API Directory: import it, store your token once, and your agent calls it, with operations discovered on demand instead of loaded into the agent's context. ### Can I limit what my agent is allowed to do with the Magic Eden API? Yes. Every operation here is read-only, and the collection symbol sits in the URL path, so a rule can scope the agent to reading one collection's listings, stats, and activities and nothing else. Every action it takes is recorded in an audit log.