NFT Butler
  • NFT Butler
    • ๐Ÿ‘‹Welcome
    • โ“What is NFT Butler?
    • ๐ŸŒฑGetting started
      • 1๏ธโƒฃGet Access
      • 2๏ธโƒฃAdd Ethereum Wallet
      • 2๏ธโƒฃAdd Bitcoin Wallet (Ordinals)
      • 3๏ธโƒฃUpdate OpenSea Name
  • Products & Services
    • ๐Ÿ’ŽPlans & Pricing
    • ๐Ÿฅ‡PRO Access
    • ๐Ÿ”ฎMagic Eden Partnership
    • ๐Ÿค–Discord Bot
      • /scan
      • /add
      • /ens
      • /refresh
      • /redeem
      • /bids
      • /sales
      • /flips
      • /traits
      • /tokenscan
  • Setup
    • ๐Ÿ”งOptimized Settings
    • ๐Ÿ’ปSetting up a VPS
    • โž•Add Collection to Butler
    • ๐Ÿ”‘Export WIF from ME Ordinals Address
    • ๐Ÿ”Security Features
  • Features
    • ๐Ÿฅ‡Butler Gold
    • ๐Ÿค–Bidding & Autolisting
    • ๐Ÿ’ฐAuto Listing Engine
    • โœ…Listing Approvals
    • ๐ŸŽ–๏ธOrdinals Token Bidding
    • ๐ŸŽฏOrdinals Collection Bidding
    • ๐ŸŒŸMagic Eden Token Bidding
    • ๐Ÿ’ŽMagic Eden Collection Bidding
    • ๐Ÿ”Blur Bidding
    • ๐ŸปBera Bidding
    • ๐Ÿ€Abstract Bidding
    • ๐ŸงขBase Bidding
    • ๐ŸŽฎArbitrum Bidding
    • ๐ŸฆApe Chain Bidding
    • โšกInstant Counter Bidding
    • ๐ŸŒCollection & Trait Analytics
    • ๐Ÿ“ŠOS & Blur Sales Stats
    • ๐ŸงฎBulk Edit
    • ๐Ÿ–๏ธBulk Create Tasks
    • ๐Ÿ“ŠDashboard
    • ๐Ÿ’ฐPerformance Overview
  • Task Types
    • ๐ŸŽฏCollection/Trait Bidding (CTO)
    • ๐Ÿš€Token Bidding
    • ๐ŸงManual Token ID Bidding
    • ๐Ÿ’ฒListing Task
  • More Resources
    • ๐Ÿ“šBest Practices
    • โ“FAQ
      • Fresh Installation of NFT Butler
      • Retrieve NFT Butler Log Files
      • Reset all tasks and Local Database in case of major issues
      • How do I get support?
      • What personal details have to be stored to use NFT Butler?
      • Do I need an API key for Opensea?
      • Is it possible to get a preview of the service?
      • What operating systems are supported?
      • Will my Tasks resume if my computer restarts for any reason?
      • Do I need an OpenSea API Key?
      • What marketplaces are supported?
      • A JavaScript error occurred
      • API Error: 429 (Rate Limited)
Powered by GitBook
On this page
  • Required Parameters
  • Optional Parameters
  • Output
  1. Products & Services
  2. Discord Bot

/tokenscan

Previous/traitsNextOptimized Settings

Last updated 1 year ago

/tokenscan will provide a list of token ids of a given collection, trait type and trait value which can be used to create manual token bidding tasks in Butler.

It can be used blockchain agnostic. So it works for Base Collections as well as Ethereum or Blast collections.

To get a full list of all available traits per collection have a look at the .

/tokenscancan be used in the channel:

Required Parameters

  • collectionslug:Specify the collection slug you want to scan. Full links to the collection on OpenSea can be posted here.

  • traittype: Specify the trait category

  • traitvalue: Specify the trait value

Trait Types and Trait Values are not case senstive in general.

Examples:

Optional Parameters

  • None

Output

The Community bot will directly send back an export of the token ids for the requested trait of the given collection.

Please note the first section "Categories" is providing an overview of the available trait types while the next section "counts" is then providing details about each Trait Type and their values including the counts (available assets)

Also make sure to check some of the provided token ids on OpenSea to double check they are really owning the requested trait. We're using the OS API here so it should match 1:1 with their indexed metadata but safety first.

So in this example I was requesting: "Nose" => "Clown": 414

Then I created a manual task for collection basedpunks and copy & paste the provided token id list:

And when running the Task I check the total jobs count to be very close to the expected 414 jobs (as we're ending up with 413 bids it seems there is one banned asset with this trait on OS):

This information can then be used for thecommand to get a full list of all Token IDs for a given trait.

Also when you paste the list into Butler the number of Jobs should match the Trait count provided by the very closely (Banned assets are excluded):

๐Ÿค–
/tokenscan
Traits Command
Traits command
Community-Bot
Requesting all token ids with Mouth => Cope for the collection "Basedpunks" on Base chain
Providing full OS link as collection slug and requesting token ids for "Eyes" with "3D" trait value
Providing collection slug only and requesting Token IDs for Nose = Clown
Bos is providing a full list of token ids for the requested trait. This list can be used to create a Manual Token Bidding Task in Butler.
Creating a manual Base Bidding Task with the copy & pasted Token ID List