# Listing Task ## **Feature Overview** * [x] Supports Listing on **OpenSea**, **Magic Eden**, **Blur** and **OpenSea PRO** * [x] Supports the following Blockchains**: Ethereum, Base, Bitcoin (Ordinals)** * [x] Fees are automatically reduced to the minimum amount possible * [x] Undercutting Collection FP, Trait FP and Token FP (ERC-1155) * [x] Linear price reductions are also supported * [x] Linear price interval can be used on top of floor price undercutting * [x] Automatically skips listing if there is a higher bid available * [x] End listing price is always protected * [x] Instant Undercutting on OpenSea {% hint style="info" %} Listing on Magic Eden, Blur and OpenSea Butler will be default use minimum fees when doing listing automation: * 0.5 % fees on OpenSea * 0.5 % on Blur * 0.0 % fees on Magic Eden If collection royalties are enforce they will be added on top. Advanced Trait FP undercutting requires[ PRO Access](https://docs.nftbutler.io/nft-butler/products-and-services/pro-access) {% endhint %} ## Creating Listing Task On the [Listing Engine](https://docs.nftbutler.io/nft-butler/features/auto-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 {% hint style="info" %} Once you've created the first Listing task on an asset it will be moved from Storage to Listings section. {% endhint %} 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:

{% hint style="info" %} 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. {% endhint %} 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:

{% hint style="info" %} Bitcoind Listing Tasks will use Expiration time just for linear Undercutting Interval. Listings for Ordinals are always created without any Expiration time. {% endhint %} ### Listing Prices If undercutting is enabled a Start and an End Listing Price can be defined:

Starting to list at 0.2 ETH and ending at 0.119 ETH

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:

{% hint style="info" %} Butler will automatically ignore your own listing orders when fetching Floor Price data and will also search for the best listing price in case some listings are below your end listing price. * Collection Floor Price undercutting * Trait Floor Price undercutting ([PRO Access](https://docs.nftbutler.io/nft-butler/products-and-services/pro-access) only) {% endhint %} ### 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. Tasks will basically defend the selected floor price but also reduce the listing price every 2 hours when nothing else happened. {% hint style="info" %} In order to use this option the [Expiration Time](#expiration-time) must be longer than the Linear Undercutting intervall here. {% endhint %} ### Looping Settings The looping configuration defines how often the task should check the selected undercutting strategy. It needs to be at least 1 minute. {% hint style="info" %} Use the Floppy Disc icon next to the configurations to set your default values for future listing tasks. {% endhint %}

### 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.

No listing notifications will be shown for this listing task

### 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](#instant-undercutting) 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.

Instant Undercutting can counter list every 5-6 seconds

### Only list when lowest This option will prevent any listings if the end listing price is above the chepeast listing at listing time.

### 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 {% hint style="info" %} Collection Approvals can be done automatically with Butler on ETH collections. For Base approvals have to be done manually by listing an asset of each collection at least once manually. {% endhint %}

With the Approve Button approvals can be done through Butler

The approval form will preview Estimated gas fees to send the approval request for the given marketplace

You can rescan the contract approvals made on your wallet after doing the manual listing

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](https://docs.nftbutler.io/nft-butler/features/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 {% hint style="info" %} 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. {% endhint %}