Magic Eden
FinanceConnect AI agents to Magic Eden, a multi-chain NFT marketplace. Agents read collection and token data, inspect wallet holdings, and query AMM pool state across supported chains.
What This Integration Enables
This connector reads. It cannot trade, and the reason is worth stating because it defines what the integration is for. Magic Eden's trading endpoints return unsigned Solana transactions that have to be signed with a wallet private key, and FlowRunner does not hold wallet keys. Listing, buying, bidding and escrow moves therefore cannot be completed from a workflow at all. That is a hard boundary drawn by the key custody model, not a roadmap item, and it happens to describe the shape we think most agent work in this space should have anyway: the machine watches continuously and assembles the case, the person holding the key moves the money.
Inside that boundary the surface is wide. On collections an agent pages the Solana collection index, pulls live floor price, listed count, average price and volume for a time window, and reads active listings with price bounds and trait filters. It walks the listing, delisting, bid and sale activity stream, enumerates every trait type and value with per-trait floors, ranks the wallets trading a collection by volume, and surfaces trending and Launchpad collections. On a single NFT it reads on-chain metadata, owner, attributes and royalties, active listings, standing bids and full marketplace history. On a wallet it reads the Magic Eden profile, held tokens filterable by collection and trait, marketplace activity, bids made, bids received, and the escrow balance that backs collection bids. On liquidity it reads MMM pool spot prices, curves and fees, plus the best pool bids on a single token. Two details determine whether any of that is usable in a flow. Collection statistics report prices in lamports while listing and offer records report SOL, so a threshold comparison across the two is off by a factor of a billion unless the agent normalizes. And Get Popular Collections can legitimately return an empty array when Magic Eden has published no ranking for the requested range, which is an absence of data rather than a market signal. There is no trigger and no webhook subscription here, so every watch is a scheduled poll.
Without FlowRunner
With FlowRunner
Use Case Scenarios
A floor series you actually own
An agent samples Get Collection Stats for a watchlist on a fixed cadence, converts the lamport figures to SOL, and appends each reading with its timestamp to Google Sheets or a warehouse table in BigQuery. Over weeks that produces a series nobody had to remember to record, and because the sample carries listed count and volume alongside price, a floor drop can be read against whether supply moved with it. The value here is not the individual call. It is that the sampling never skips a day.
A portfolio view assembled from four reads
A holder wants one view of a wallet. The agent calls Get Wallet Tokens for holdings, Get Wallet Offers Received for what could be accepted today, Get Wallet Offers Made for open exposure on other people's tokens, and Get Wallet Escrow Balance for whether those bids can actually settle. It then joins the collections involved with Get Collection Stats for current floors. The result posts to a channel in Slack as a single summary. A zero escrow balance is called out explicitly, because it means the wallet's collection bids cannot settle even though they are still shown as standing.
A crossing that ends in a person, not an order
A watched collection's floor crosses a threshold. The agent reads Get Collection Stats for the crossing, Get Collection Listings for the actual asks sitting at that level, and Get Best Pool Offers and Get AMM Pools for the automated market maker liquidity standing behind an instant sell. It posts all of it together, labelled with units, to the trading channel. It does not place an order, because it cannot, and the page you are reading would be lying if it implied otherwise. The alert exists to put a decision in front of a person faster, with the depth attached.
Human-in-Loop Highlight
The interesting thing about Magic Eden is that the human-in-the-loop moment is structural rather than configured: the wallet key never enters FlowRunner, so the last thing the agent produces before value moves is always a brief for a person. What the agent owes that person is honesty about the reading. Get Collection Stats reports in lamports and Get Collection Listings reports in SOL, so a threshold alert built across both is wrong by nine orders of magnitude in a way that looks perfectly plausible on screen. Get Popular Collections returns an empty array when no ranking was published rather than when nothing is trending. So the agent states its arithmetic: "SAMURAI floor from Get Collection Stats is 12,400,000,000 lamports, which is 12.4 SOL. The lowest three asks from Get Collection Listings are 12.4, 12.5 and 12.9 SOL. Best pool offer from Get Best Pool Offers is 11.8 SOL against 340 SOL of buyside liquidity. Your threshold was 12.5. Act, or hold?" The holder decides and signs in their own wallet. The agent's job is to make sure the number the human is deciding on is the number the API actually returned, in the unit the API actually returned it in.
Agent Capabilities
20 actionsCollections
8- Get Collections Lists NFT collections indexed by Magic Eden on Solana, returning each collection's symbol, name, description, image, category tags and social links. The symbol returned here is the identifier every other collection operation expects. Results are paged, and the offset must be a multiple of the limit.
- Get Collection Stats Returns live market statistics for a single Solana collection, including floor price, listed count, 24 hour average price and traded volume. Prices are reported in lamports, so divide by 1,000,000,000 to convert to SOL. Use the time window parameter to scope volume figures to a period.
- Get Collection Listings Returns the active listings for a Solana collection, each with its token mint, seller, price, auction house and rarity ranks. Supports price bounds, trait filtering, sorting and paging, and can optionally include listings aggregated from other marketplaces. Prices in the price filters are expressed in SOL.
- Get Collection Activities Returns the recent on-chain marketplace activity for a Solana collection, such as listings, delistings, bids and sales. Each record carries the transaction signature, activity type, token mint, buyer or seller, price and block time. Results are ordered newest first and are paged.
- Get Collection Attributes Returns every trait type and trait value available in a Solana collection, along with how many tokens carry each trait and the floor price for that trait. Use it to discover the exact trait names and values accepted by the attribute filters on Get Collection Listings and Get Wallet Tokens.
- Get Collection Leaderboard Returns the wallets that traded a Solana collection ranked by total volume, with each wallet's traded volume in lamports and the timestamp of its most recent trade. Useful for identifying the most active traders in a collection.
- Get Popular Collections Returns the Solana collections trending on Magic Eden over a chosen time range, ranked by marketplace activity. The response can be empty when Magic Eden has not published a ranking for the requested range, which is an absence of data rather than a signal.
- Get Launchpad Collections Lists the collections minting or scheduled to mint on the Magic Eden Launchpad, including the mint price, supply, launch date and project links. Use it to monitor upcoming Solana drops. Results are paged.
Tokens
4- Get Token Returns the on-chain metadata for a single Solana NFT identified by its mint address, including the current owner, collection, name, image, attributes, creators, royalty basis points and burn status. Compressed NFTs are supported by passing the asset ID instead of a mint address.
- Get Token Listings Returns the active sale listings for a single Solana NFT, including the asking price, seller, auction house and the SPL token the seller accepts. An empty array means the NFT is not currently listed.
- Get Token Offers Received Returns the standing bids placed on a single Solana NFT, each with the bidder, bid amount, auction house and expiry. Supports price bounds, sorting and paging so a flow can isolate the strongest current offer on a token.
- Get Token Activities Returns the marketplace history of a single Solana NFT, covering listings, delistings, bids, cancellations and sales, each with the transaction signature, counterparty, price and block time. Records are ordered newest first and are paged.
Wallets
6- Get Wallet Returns the Magic Eden profile associated with a Solana wallet address, including the display name and profile image when the owner has set one. Wallets with no Magic Eden profile return just the address, so treat the extra fields as optional.
- Get Wallet Tokens Returns the Solana NFTs held by a wallet, each with its mint address, collection, name, image, attributes and current listing state. Supports narrowing to one collection, filtering by listing status, price bounds and traits, plus sorting and paging.
- Get Wallet Activities Returns the marketplace activity performed by a Solana wallet, covering its listings, bids, cancellations, purchases and sales across every collection. Each record carries the transaction signature, activity type, token mint, collection, price and block time.
- Get Wallet Offers Made Returns the outstanding bids a Solana wallet has placed on other people's NFTs, each with the target token mint, bid amount, auction house and expiry. Use it to audit a bidder's open exposure across collections.
- Get Wallet Offers Received Returns the bids other buyers have placed on NFTs currently held by a Solana wallet, each with the bidder, bid amount, target token mint and expiry. Use it to review every offer a holder could accept.
- Get Wallet Escrow Balance Returns the Magic Eden escrow account address for a Solana wallet and the SOL balance currently held there. Escrow funds back collection bids, so a zero balance means the wallet cannot settle escrow-funded offers.
AMM Pools
2- Get AMM Pools Lists Magic Eden MMM automated market maker pools, returning each pool's spot price, bonding curve type and delta, LP fee, royalty share, owner and buyside liquidity. At least one of Collection Symbol or Owner must be supplied.
- Get Best Pool Offers Returns the highest AMM pool bids available for a single Solana NFT, best offer first. These are the instant sell prices a holder could take from automated market maker liquidity rather than from an individual bidder. Request up to five offers to compare the depth behind the top bid.
Frequently Asked Questions
What can FlowRunner do with Magic Eden?
FlowRunner agents can run Get Collections, Get Collection Stats, and Get Collection Listings in Magic Eden, plus 17 more actions.
Does connecting Magic Eden to FlowRunner require OAuth?
No. Magic Eden connects to FlowRunner with an API key, no OAuth flow required.
Can Magic Eden trigger a FlowRunner workflow automatically?
Magic Eden doesn't currently expose triggers in FlowRunner. It connects as an action step inside workflows started by another trigger.
Start building with Magic Eden
$100 in credits. No card required. Connect in minutes.