๐Ÿ’ฒListing Task

Feature Overview

Listing on Magic Eden, Blur and OpenSea PRO requires PRO Access

Butler will be default use minimum fees when doing listing automation:

  • 2.5 % fees on OpenSea (for non PRO Members)

  • 0.5 % fees on OpenSea PRO

  • 0.5 % on Blur

  • 0.0 % fees on Magic Eden

If collection royalties are enforce they will be added on top.

Creating Listing Task

On the Listing Engine page you can find the Assets section at the bottom. On the right upper side you can choose between "Listings" and "Storage" section:

  • Listings: All assets whith at least 1 configured listing task

  • Storage: All assets held in any wallet added to your Butler

Once you've created the first Listing task on an asset it will be moved from Storage to Listings section.

Now for each marketplace a Listing Task can be created per Asset. If a market is greyed out with "Blocked" it doesnt allow listing this collection. Use the "+" icon to create your first listing task:

There is also a Refresh Button top left right next to the Assets title on the Storage tab. It will refresh all assets in your wallet if you jsut transfered a new asset.

All options of a Listing Task will be explained below. A fresh listing task will automatically load previous settings if there was already a task created on a different marketplace on the same asset.

Expiration Time

Us this field to define the duration of the listing. Butler will automatically refresh your listing once the Expiration Time has expired:

Bitcoind Listing Tasks will use Expiration time just for linear Undercutting Interval. Listings for Ordinals are always created without any Expiration time.

Listing Prices

If undercutting is enabled a Start and an End Listing Price can be defined:

If undercutting is disabled a single listing price can be defined:

Undercutting options

When undercutting is enabled there are 4 different Undercutting Strategies to choose from:

  1. Linear: This option will always lower your listing price by the defined "Undercutting Steps" when the Expiration Time has expired.

  2. Collection: With this option Butler will monitor the Collection floor price with a given interval (Looping Interval) and always undercut it. The End Listing Price will always be respected as the lowest possible listing price.

  3. Trait: Here a trait of the asset can be choosen from the dropdown list and Butler will keep undercutting the Trait Floor Price up to the End Listing Price. However it's only Available for collections added to the search engine of Butler.

  4. Token FP (ERC-1155): When listing ERC-1155 Assets with multiple copies this option will monitor the Token Floor Price and keep undercutting it.

The following example will keep undercutting the Trait "DNA: Angel" with undercutting steps of 0.001 ETH. The Trait FP will be checked every 5min due to the set Looping Interval:

Linear Undercutting

Now when running a Listing task which is undercutting either Collection, Trait or Token Floor Prices you can add a Linear Undercutting strategy on top.

Now this option will additional reduce the listing price if the Linear Undercutting Interval has been exceeded since your last listing change, by the Undercutting Steps value.

So the task will basically defend the selected floor price but also reduce the listing price every 2 hours when nothing else happened.

Looping Settings

The looping configuration defines how often the task should check the selected undercutting strategy. It needs to be at least 1 minute.

Use the Floppy Disc icon next to the configurations to set your default values for future listing tasks.

Enable Notifications

By default Notifications are turned off which means Butler will not reports Listing events for this asset on the Notifications System. It can get very noisy in the notifications if you do enable it as a lot of listing events can happen on each Asset.

Disable highest bid protection

By default listing tasks will skip listings if there is a higher bid active than the final listing price. In some cases the bid might be very close to your actual listing price and you want to disable this safety feature. It can be done by enabling this toggle option

Instant Undercutting

PRO Members do have the option to enable instant undercutting for listing tasks on OpenSea. This option is only supported when doing Collection FP or Token FP (ERC-1155) undercutting.

Please note the Instant Counter Bidding engine needs to be running in order to make use of this feature. The ICB engine will basically subscribe to any listing event on the given collection and if someone is undercutting your listing price it will instantly react with a counter listing.

Start Task Immediately or Queue

This option will play the task after creation to make sure the Listing engine will pick it up immediately.

Collection Approval

In order to be able to Create a Listing Task the collection of the asset needs to be listed at least once manually on the given marketplace. Butler will check your approved contract per Wallet to check if the approval has been given already or not.

If the approval wasn't given there is also a refresh button to check again once you have processed the manual listing on the marketplace:

This step will be simplified in the future with automated listing approvals as part of your bidding tasks to use Butler as fully automated buying and selling machine.

Once the collection was approved, the listing task can be created:

Asset Listings Overview

Now the asset will be moved to the Listings section after creating the first listing task. In order to run your listing Tasks the Listing Engine has to be enabled first (on the Butler Dashboard or in the header Bar):

Further each Listing task will highlight if the Asset is currently Listed at it's marketplace, what the current listing price is followed by the Task Action Buttons:

  • First Button is used to Pause / Play the task

  • Second Button will open the edit Modal for the task

  • Third Button deletes the Listing Task

  • Fourth Button opens the detailed Logs to see what is happening on each Listing Task

Listing tasks are also automatically deleted when an asset is sold.

When Listed is highlighted in green it means you're currently defining the floor price with this listing.

Last updated