> For the complete documentation index, see [llms.txt](https://docs.coinsense.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coinsense.app/discord-structure/bot-interactions.md).

# Bot interactions

Token interactions are allowed in all Discord channels but preferred to do in #bot\_commands channel.

<figure><img src="/files/v0KsvIOqqj27r79LCx7b" alt=""><figcaption></figcaption></figure>

You can use various endpoints to get data about specific tokens or smart money moves from last day or last week.

**List of endpoints:**

`/token_stats` -> find information about a token that you want to buy or see a change for a token that you are already holding

Under token stats you can also find a table with holdings of tracked influencer wallets and smart money wallets:

<figure><img src="/files/Nz7WK7SyIxrtznGzn4mI" alt=""><figcaption><p>Example of token stats</p></figcaption></figure>

`/top_tokens` - tokens with most SMWs+Influencers in (can be used with market cap limit or for a specific chain).

{% hint style="info" %}
Example: /top\_tokens filter\_network:base max\_market\_cap:50000000
{% endhint %}

<figure><img src="/files/jorXe9UdMEAUdN2ad2XX" alt=""><figcaption><p>Example of top token held by SMW</p></figcaption></figure>

`/top_accumulations` - Most accumulated tokens by SMWs based on your defined timeframe (can be used with market cap limit, wallet\_type or chain filters). Coins are sorted by score which is calculated by the impact of the flows.

<figure><img src="/files/njBjvt26pI8ItB6qfLYY" alt=""><figcaption><p>Top token accumulations by SMW in last 30 days</p></figcaption></figure>

`/worst_tokens` -> Top sold tokens by SMWs based on score in a defined timeframe

<figure><img src="/files/Q7zlm1ya8gU4VVfiyBRK" alt=""><figcaption><p>Most sold tokens by SMW in last 30 days</p></figcaption></figure>

`/top_smw_wallets_changes` -> tokens with the biggest SMWs change (net inflow) in specified timeframe

<figure><img src="/files/oPFUq0dno0ujoijVe6nA" alt=""><figcaption><p>Example of tokens with biggest change in smart money wallets holding the token in last 30 days</p></figcaption></figure>

`/fresh_accumulations` - Most accumulated tokens by smart money wallets in last 4 hours (mainly for quick overview).

<figure><img src="/files/zLSy7pVjckIVXZfRALQb" alt=""><figcaption><p>Example of fresh accumulations</p></figcaption></figure>

`/fresh_tokens` - Most accumulated fresh/new tokens by SMW in last 24 hours

<figure><img src="/files/V8rTCsxECM8fFxx3b64U" alt=""><figcaption><p>Fresh tokens report</p></figcaption></figure>

`/young_tokens` - Most accumulated fresh/new tokens by SMW in last 7 days

<figure><img src="/files/rEMyUTssCs5gsCetch3f" alt=""><figcaption><p>Young tokens report</p></figcaption></figure>

`/smw_stats` - Daily statistics checking if smart money wallets are investing or not&#x20;

<figure><img src="/files/TMd06VK0BVI5aRSkShSD" alt=""><figcaption></figcaption></figure>

`/influencer_trades` (👑 premium only) - trading volume for a specified day range for specified influencer (if we track his wallets)

<figure><img src="/files/nQq1OsWyoVXmYANzRjLu" alt="" width="456"><figcaption><p>Example of influencer summary in last 7 days</p></figcaption></figure>

`/influencer_holdings` (👑 premium only) - type partial match with any of the influencers we're tracking and get overview of his holdings on all of his wallets.

<figure><img src="/files/15WpZosrVsypZuxG4EU5" alt=""><figcaption></figcaption></figure>

`/trending_narratives` (👑 premium only) - CoinSense differs between trending chains and trending narratives.

In the case of **trending chains** we're accumulating data about 70 chains and it's onchain volume & TVL. Score is a combination of the onchain volume growth (calculated only from the chain main DEXes) and TVL growth.

In the case of **trending narratives** we're monitoring around 100 different large cap tokens representing different narratives. Once any of the large cap representative token pumps we can expect related small cap tokens to pump too.

<figure><img src="/files/Gf7F8BJGuh2dtByApwlG" alt=""><figcaption></figcaption></figure>

`/search_projects` (👑 premium only) - fulltext search engine based on the project that SMW historically interacted with. You can use simple search query to find projects related to your query (project must contain the query on the homepage) including full data about smart money wallets in:

<figure><img src="/files/hWotkOJtv2Lc8xXE2xA1" alt=""><figcaption><p>Example of search_projects endpoint results. Full results are available in Excel table generated for premium user.</p></figcaption></figure>

Pro tip: You can use **OR** operator to cumulated results of more queries into one like this:

`rwa OR real-world assets OR real world assets`

`ai OR artifical intelligence`

`/token_limit_swaps` (👑 premium only) - CoinSense is real-time monitoring all limit swap signs on 1inch and Matcha and aggregate those data. You can simply search for any token (like "BANANA" or it's contract address) and get an overview of where other traders had set their limit swaps.

#### How you could use info like that?

1\) To estimate the entry and take profit zones of other traders

2\) To identify strong/weak tokens based on the number of buy/sell limit swaps close to the current price

3\) To find buy/sell walls (limit swaps with big size that probably will not be consumed by the market easily)

4\) To catch new opportunities in fundamental coins (usually limit buys are made only on tokens where you're nearly sure it'll not rug)

<figure><img src="/files/SyH5FSZX5bpwQ07bLxlm" alt=""><figcaption><p>Example of /token_limit_swaps endpoint output for the token BSSB</p></figcaption></figure>

### CEX SMW related commands

`/cex_top_accumulations` -> top longed/shorted coins on CEX (Hyperliquid SMWs) filtered by long/short, in specific timerange from 5min to 7 days

<figure><img src="/files/wZreh5kfBgOAECMnGcFr" alt=""><figcaption></figcaption></figure>

`/cex_smw_stats` -> are SMWs on Hyperliquid long or short during the latest days/hours?

<figure><img src="/files/EYoM430Imqk2M9C8xDD7" alt=""><figcaption></figcaption></figure>

Filters used to narrow down the results:

* **wallet\_type** -> filter based on SMWs with long-term buys (Holder) or short-term (Scalper)
* **filter\_network** -> enables to filter results by specific chain such as Ethereum, Solana, Base etc.
* **max\_market\_cap** -> specify that you want to see for example only coins below 100mil. Mcap
* **days\_back** -> how many days back you want to return data
* **max\_days\_old** -> filter tokens based on their age
* **timeframe** -> specify the preset timeframe (only for trending\_narratives, cex\_smw\_stats, cex\_top\_accumulations)