# /tokenscan

{% hint style="info" %}
/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 [Traits command](https://docs.nftbutler.io/nft-butler/products-and-services/discord-bot/traits).
{% endhint %}

`/tokenscan`can be used in the [Community-Bot](https://discord.com/channels/910479328746287104/947522708546134046) channel:

<figure><img src="https://156458129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUpGMSshbhuSUXHzoKrTn%2Fuploads%2FM465B2tP1BCM8OB27gYI%2Fimage.png?alt=media&#x26;token=1c578729-ee78-4bf0-a14c-bb68454cbeda" alt=""><figcaption><p>Requesting all token ids with Mouth => Cope for the collection "Basedpunks" on Base chain</p></figcaption></figure>

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

<figure><img src="https://156458129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUpGMSshbhuSUXHzoKrTn%2Fuploads%2F30qIGn3zQZ2un7y2YVgW%2Fimage.png?alt=media&#x26;token=bcebb666-d37d-4b2c-a2bf-a7a627c97038" alt=""><figcaption><p>Providing full OS link as collection slug and requesting token ids for "Eyes" with "3D" trait value</p></figcaption></figure>

<figure><img src="https://156458129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUpGMSshbhuSUXHzoKrTn%2Fuploads%2FE4z7bHLNNmDX0eQXXgFg%2Fimage.png?alt=media&#x26;token=62bdf325-f999-4578-b071-225ecfb23cc4" alt=""><figcaption><p>Providing collection slug only and requesting Token IDs for Nose = Clown</p></figcaption></figure>

### Optional Parameters

* None

### Output

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

This information can then be used for the[ /tokenscan ](https://docs.nftbutler.io/nft-butler/products-and-services/discord-bot/tokenscan)command to get a full list of all Token IDs for a given trait.
{% endhint %}

<figure><img src="https://156458129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUpGMSshbhuSUXHzoKrTn%2Fuploads%2FCuym8L37uaznW8TRH496%2Fimage.png?alt=media&#x26;token=9dd8be4c-182c-4bab-9094-6655812ca74a" alt=""><figcaption><p>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.</p></figcaption></figure>

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.

Also when you paste the list into Butler the number of Jobs should match the Trait count provided by the [Traits Command](https://docs.nftbutler.io/nft-butler/products-and-services/discord-bot/traits) very closely (Banned assets are excluded):

So in this example I was requesting: `"Nose" => "Clown": 414`&#x20;

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

<figure><img src="https://156458129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUpGMSshbhuSUXHzoKrTn%2Fuploads%2FylsJOeBjAaS1KWPhkrq1%2Fimage.png?alt=media&#x26;token=b763d571-734b-4fb0-8884-344c04659691" alt=""><figcaption><p>Creating a manual Base Bidding Task with the copy &#x26; pasted Token ID List</p></figcaption></figure>

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):

<figure><img src="https://156458129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUpGMSshbhuSUXHzoKrTn%2Fuploads%2FNkT9ak3Pa7GRuQ0GAQBV%2Fimage.png?alt=media&#x26;token=10827d0f-2d33-4f3e-8076-ae6061c4dcf9" alt=""><figcaption></figcaption></figure>