Magic Eden Setup Guide

Time: 15 minutes | Difficulty: Advanced | Market: NFTs Mode: Full automation (conditional) | API: REST API + Smart contract interaction | Docs: docs.magiceden.io

This guide wires a Magic Eden NFT bot to the REST API and blockchain smart contracts using the botwir3 runtime. Configure API access, connect to multi-chain NFT markets, and run automated NFT trading strategies locally.

⚠ Access requirements

Magic Eden supports multiple chains, and API terms may vary by chain. This may include:

REST API for marketplace data (listings, collections, activity)
On-chain smart contract interaction for transactions (buying/selling)
Multi-chain support: Solana, Ethereum, Bitcoin (Ordinals), Polygon
Terms and capabilities differ by chain — verify the specific chain's API documentation

Magic Eden API Documentation | Magic Eden Terms of Service

The user is responsible for obtaining appropriate access and complying with all platform terms for the applicable chain.

Before you start

Verify that automated operation is permitted under Magic Eden's current terms of service before deploying. botwir3 provides tools for building structured automation. The user is responsible for compliance with the platform's terms and all applicable regulations.

Magic Eden Terms of Service | Last verified: May 2026

What you need

A wallet for the target chain (Solana, Ethereum, or Bitcoin)
A private key or keystore file for the wallet (stored locally — never shared)
The botwir3 runtime downloaded and unzipped
A strategy config file from the builder
An RPC endpoint for the target chain

Step 1: Configure wallet credentials

Magic Eden transactions execute on-chain. The bot uses the REST API for marketplace data and submits transactions using a wallet private key.

🔒 Security. The wallet private key controls all funds in the wallet. Use a dedicated wallet for bot operations with only the funds allocated to the strategy. The private key is stored in a local config file and is not transmitted to botwir3 or any third party. botwir3 never sees, stores, or has access to wallet credentials.

Step 2: Configure the adapter

Create adapter.json in the bot directory:

{
  "adapter": "magiceden",
  "credentials": {
    "private_key": "paste-wallet-private-key-here",
    "rpc_url": "https://api.mainnet-beta.solana.com"
  },
  "collection": "degods",
  "chain": "solana",
  "environment": "live",
  "rate_limit_ms": 2000
}

collection: The collection symbol or contract address. For Solana, use the collection symbol (e.g., "degods"). For Ethereum, use the contract address.

chain: "solana", "ethereum", "bitcoin", or "polygon".

API keys (RPC endpoint credentials) are stored in a local config file on the machine running the bot. They are not transmitted to botwir3 or any third party. botwir3 never sees, stores, or has access to wallet credentials.

Step 3: Test the connection

botwir3 test --adapter magiceden

Expected output:

[botwir3] Adapter: magiceden
[botwir3] Connection: OK (Solana mainnet-beta)
[botwir3] Wallet: 7xKX...9mPq
[botwir3] Chain: solana
[botwir3] Rate limit: per API documentation

Step 4: Start the bot

botwir3 start --config my-strategy.json

The runtime loads the strategy, computes the spec hash, connects to the Magic Eden API and the target blockchain via the configured wallet, and begins evaluating signals. The gate function compares proposed actions against the configured spec. The user is responsible for monitoring the bot and verifying execution outcomes.

Rate limits and considerations

Component	Limit	Notes
REST API	Rate-limited per documentation	Listings, collections, activity data.
Blockchain (Solana)	~400ms/slot	Low transaction fees (~$0.001).
Blockchain (Ethereum)	~12 seconds/block	Higher gas costs.

Common Magic Eden bot configurations include cross-chain collection monitoring (tracking prices on the same collection across Solana and Ethereum), floor price sniping, and trait-based bidding strategies. All actions and decisions are recorded in the local ledger.

Troubleshooting

Error	Cause	Fix
`CONNECTION_REFUSED`	RPC endpoint unreachable or API rate limited	Verify `rpc_url` in adapter config. Check Magic Eden API status.
`INSUFFICIENT_FUNDS`	Wallet balance too low for purchase + fees	Fund the wallet on the target chain
`COLLECTION_NOT_FOUND`	Invalid collection symbol or contract address	Verify the collection at magiceden.io
`MANDATE_INTEGRITY_VIOLATION`	Config file modified while bot is running	Stop the bot, verify config, restart

Related guides

OpenSea Setup Guide — NFTs, API + on-chain, Ethereum-focused
Blur Setup Guide — NFTs, on-chain only, Ethereum
Jupiter Setup Guide — DeFi swaps on Solana

One bot. $129. No subscription. No $749/mo platform. → Build for Magic Eden