# Magic Eden Token Bidding

## Features

* [x] Magic Eden bidding is available for all **Ethereum collections** via NFT Butler
* [x] Create [Collection Bidding Tasks](https://docs.nftbutler.io/nft-butler/features/magic-eden-collection-bidding) to **farm Diamonds** on Magic Eden
* [x] Butler can run a total throughput of up to **3500 bids / hour** on Magic Eden
* [x] Up to **200** Magic Eden **Token Bidding Tasks** can be created
* [x] Find **Magic Eden exclusive collections** through the Butler search engine
* [x] Create **Trait based token bidding tasks** with ease
* [x] Providing Collection Floor Prices, Trait Floor Prices, Sales and Listing stats on Magic Eden
* [x] Supporting **Safty features** for your bidding tasks such as Floor Price caps and Asset limits
* [x] **Relative bidding** to ME Collection Floor Price or **Fixed ETH Bidding**
* [x] [**Ordinals bidding**](https://docs.nftbutler.io/nft-butler/features/ordinals-token-bidding) is supported with Manual bidding tasks.
* [x] [Manual Magic Eden bidding tasks](https://docs.nftbutler.io/nft-butler/task-types/manual-token-id-bidding) can be created if you want to specify individual token id ranges.

## Prerequisite

* Base subscription or lifetime [access](https://docs.nftbutler.io/nft-butler/nft-butler/getting-started/get-access)
* Active [PRO Member subscription](https://docs.nftbutler.io/nft-butler/products-and-services/pro-access) is required in order to run Magic Eden Bidding tasks

## Search for Magic Eden collections

{% hint style="info" %}
The Butler search engine can be used to find collections hosted on Magic Eden exclusivly.
{% endhint %}

<figure><img src="https://156458129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUpGMSshbhuSUXHzoKrTn%2Fuploads%2F4NJks0TqCVJnrQRL4q4t%2Fimage.png?alt=media&#x26;token=3c4fb489-1013-4659-8aa2-7f5fc4a9b8db" alt=""><figcaption><p>Use the collection filters on the left to find Magic Eden exclusive collections only</p></figcaption></figure>

* The "Drilldown" icon on the very left will drilldown into the individual traits view of the given collection while the "Stats" icon (second from left) will provide additional Data such as collection floor price changes over the past 2 months as well as the last Sale stats

<div><figure><img src="https://156458129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUpGMSshbhuSUXHzoKrTn%2Fuploads%2FpwGCpFriReip9CTZTlcr%2Fimage.png?alt=media&#x26;token=84b57e4f-9158-4352-a537-1203ea8f9460" alt="" width="563"><figcaption><p>Trait Drilldown int a Magic Eden exclusive collection</p></figcaption></figure> <figure><img src="https://156458129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUpGMSshbhuSUXHzoKrTn%2Fuploads%2FHVWM7SKU0xK2FHYnPkS9%2Fimage.png?alt=media&#x26;token=c488af49-1f3b-4424-ad4b-19ebb1820263" alt="" width="375"><figcaption><p>Collection Stats of a ME exclusive collection</p></figcaption></figure></div>

## Create Magic Eden Bidding Task

* Magic Eden Token Bidding Tasks can be create for collection hosted exclusivly on ME or collections hosted on other market places too
* A token Bidding task can either be created for an entire collection (bidding on each token 1 by 1), for a specific trait (bidding on each token owning a certain trait) or a combination of multiple traits (bidding on each token owning at least 1 trait (OR condition) or all traits together (AND condition))
* Collection CTO bidding tasks are not yet supported with Butler but will be added later on!

{% hint style="info" %}
From the search engine you can either drilldown into the Traits of a collection or create a Token Bidding task directly on the collection itself for all it's assets
{% endhint %}

<figure><img src="https://156458129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUpGMSshbhuSUXHzoKrTn%2Fuploads%2FYlOUyGJ68pJs5uynaNlm%2Fimage.png?alt=media&#x26;token=04476eba-be14-4a83-926e-57d37dae97a8" alt=""><figcaption><p>Button on the very left leads to the Trait Drilldown while button on the very right creates a token Bidding task on collection level</p></figcaption></figure>

{% hint style="info" %}
From the Trait drilldown view you'll have the same option to create a token bidding task but now targeting a specific trait only, or even a combination of traits by multi selecting them.
{% endhint %}

<figure><img src="https://156458129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUpGMSshbhuSUXHzoKrTn%2Fuploads%2F8btVccpeVu0t8OWbcX86%2Fimage.png?alt=media&#x26;token=e18d7758-3019-444a-82ae-95ec647dec4d" alt=""><figcaption><p>Trait drilldown let's you create Magic Eden Bidding tasks based on single traits or combinations of them!</p></figcaption></figure>

* Once you're creating a Token Task you'll be able to choose if the Task should be running on OpenSea or MagicEden
* If a collection is available on MagicEden only, only one selection is possible. Same for collections hosted on OpenSea exclusively
* The market place target can also be changed later on when the task was created
* For all the token task configuration options please refer to [Token Bidding Tasks](https://docs.nftbutler.io/nft-butler/task-types/token-bidding)

<figure><img src="https://156458129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUpGMSshbhuSUXHzoKrTn%2Fuploads%2F0HIVRELtC6u1x0KMEcdA%2Fimage.png?alt=media&#x26;token=bc3f56c0-a0f8-45dd-948c-aabba84417ef" alt=""><figcaption><p>Create a Magic Eden trait based bidding task for "Role: Enchanter"</p></figcaption></figure>

## Running Magic Eden Bidding Tasks

* Magic Eden Bidding tasks can be found on the Token Task page and are marked with a small market place icon below the collection avatar
* Filtering option is available to show ME Bidding tasks only
* A dedicated ME Bidding task slot is reserved at the bottom of the **Running** section. It's a super-charged task slot which process about **2500 - 3000 bids / hour**
* Normal task rotation rules apply. Once a task has **finished** it jobs it will **pick** the next Bidding task from the **Queued** section

<figure><img src="https://156458129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUpGMSshbhuSUXHzoKrTn%2Fuploads%2FSVMmFp2iT4O7RoqO2dCf%2Fimage.png?alt=media&#x26;token=f6c0d6f2-d4d9-46ea-9cb0-fe96f2989793" alt=""><figcaption><p>Filtering for magic Eden Bidding tasks. Tasks will use a dedicated super charged slot at the end of the Running section</p></figcaption></figure>

{% hint style="info" %}
To approve your WETH spending limit please process a manual ETH bid from your wallet before running Bidding tasks on Magic Eden. Otherwise an error message will be highlighted
{% endhint %}

<figure><img src="https://156458129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUpGMSshbhuSUXHzoKrTn%2Fuploads%2FKWMFWZVEAl1seh4sSHZ4%2Fimage.png?alt=media&#x26;token=06e4a528-0a5b-48fa-abf9-f5778baa17e7" alt=""><figcaption><p>WETH spending limit reached. Process a manual bid from this Wallet on Magic Eden</p></figcaption></figure>

## Dashboard & Wallt Details

* Magic Eden Bidding Tasks will be part of the Live Bidding Activity Feed on the [Dashboard Overview](https://docs.nftbutler.io/nft-butler/features/dashboard)
* Also the "Target" link will link to Magic Eden if the bid was coming from a Magic Eden bid
* However the wallet percentage for the WETH limits are not taking ME bids into account (as they are not processed on OpenSea)
* Wallet Details will show active bids on Magic Eden seperatly on the bottom of the list

<figure><img src="https://156458129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUpGMSshbhuSUXHzoKrTn%2Fuploads%2FqcQ2BmAb094ufE8rVX2i%2Fimage.png?alt=media&#x26;token=6e4d5e59-aece-4857-b964-382581793b2d" alt=""><figcaption><p>Butler Dashboard showing live bidding activity for both OS and ME Bids. But Wallet percentag only taking OS bids into Account</p></figcaption></figure>

<figure><img src="https://156458129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUpGMSshbhuSUXHzoKrTn%2Fuploads%2FOoAofksXLdy4kCkk9V7e%2Fimage.png?alt=media&#x26;token=5340ea40-2e61-4571-a0f7-836e4071f2ac" alt=""><figcaption><p>Wallet Details showing active Magic Eden bids seperatly. They are not counting towards OpenSea active bids limits</p></figcaption></figure>
