> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clyrbot.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Web3, Tokens & NFT Analytics

> Real-time token contract scanning, DEX liquidity metrics, Group ATH call leaderboards, NFT collection analytics, and daily drop radars.

## `/scan` — Token Contract Scanner

Inspects any Solana or EVM token contract address (CA) or DexScreener link on demand, returning live price, market cap, liquidity pool depth, 24-hour volume, and caller logging.

### Syntax

```bash theme={null}
/scan <contract_address|dexscreener_url|ticker>
```

**Aliases:** `/ca`, `/token`

### Parameters

| Parameter | Type | Required | Description |
| :- | :- | :- | :- |
| `contract_address` | String | **Yes** | Solana Base58 address, EVM `0x` address, DexScreener URL, or `$TICKER` symbol. |

### Supported Networks

* **Solana**: Raydium, Meteora, Pump.fun, Orca
* **Base**: Uniswap V2/V3, Aerodrome, BaseSwap
* **Ethereum**: Uniswap V2/V3, SushiSwap, Curve
* **BNB Smart Chain (BSC)**: PancakeSwap V2/V3
* **Arbitrum & Polygon**: QuickSwap, Camelot, Uniswap V3

### Example Invocations

```bash theme={null}
/scan DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263        # Solana token
/scan 0x532f27101965dd16442e59d40670faf5ebb142e4        # Base EVM token
/scan https://dexscreener.com/solana/...                 # Direct link
/scan $BRETT                                            # Ticker resolution
```

### Response Format

Clyr responds with the official token banner/logo and rich metrics:

```text theme={null}
💎 Brett (BRETT) • 🔵 Base
💵 Price: $0.0842 (+14.2% 24h)
📊 Market Cap: $842,120,400 | FDV: $842.12M
💧 Liquidity: $18,450,210 (Pool: BRETT/WETH)
📈 24h Volume: $42,850,910
👥 Txns (24h): 38,410 (21,200 buys / 17,210 sells)

📢 First Called in this group by: @2348057416596
🔗 Trade: https://dexscreener.com/base/0x532f2...
```

***

## `/ga` — Group ATH Token Call Leaderboard

Ranks community members by the highest peak multiplier (**X's**) achieved on tokens called inside the chat.

### How Group Alpha Tracking Works

```
1. Caller drops CA in chat        ──> Clyr logs Initial Market Cap ($250K) & Caller ID
2. Token rallies on DEX            ──> Sentinel engine records Peak Market Cap ($1.5M)
3. Member runs /ga [timeframe]    ──> Clyr ranks caller at 6.0x Multiplier (🔥)
```

### Syntax

```bash theme={null}
/ga [timeframe]
```

**Aliases:** `/ath`, `/leaderboard`

### Parameters

| Parameter | Type | Required | Default | Supported Values |
| :- | :- | :- | :- | :- |
| `timeframe` | String | No | `30d` | `24h`, `7d`, `30d`, `all` |

### Leaderboard Output Format

```text theme={null}
🏆 MANDEM 🫂❤️🦅 — ATH CALL LEADERBOARD
⏱️ Period: Past 30 Days

🥇 @2348057416596 — $BRETT
   Called: $250.0K ➡️ Peak: $1.50M (6.0x 🔥)

🥈 @Alex — $POPCAT
   Called: $1.20M ➡️ Peak: $4.80M (4.0x 🚀)

🥉 @DamiCrypto — $BONK
   Called: $500.0K ➡️ Peak: $1.25M (2.5x 📈)

Multipliers calculated strictly from peak reached after call
● Automated by Clyr
```

***

## `/scan-on` & `/scan-off` — Contract Auto-Detection Toggles

Controls whether Clyr automatically intercepts and scans raw Solana and EVM contract addresses pasted in the group.

```bash theme={null}
/scan-on     # Enables zero-prefix contract auto-detection
/scan-off    # Disables auto-detection (members must use /scan <CA>)
```

> [!NOTE]
>
> Toggling contract auto-detection requires **Group Administrator** privileges.

***

## `/nft` — NFT Collection Analytics

Retrieves real-time collection metrics and floor prices directly from OpenSea and secondary marketplaces, accompanied by the collection's official high-resolution banner.

### Syntax

```bash theme={null}
/nft <slug_or_url>
```

### Parameters

| Parameter | Type | Required | Description |
| :- | :- | :- | :- |
| `slug_or_url` | String | **Yes** | OpenSea collection slug (e.g. `pudgypenguins`) or complete OpenSea collection URL (`https://opensea.io/collection/mooncats`). |

### Returned Intelligence

* **Floor Price**: Live floor price in native asset (ETH, SOL, MATIC) and converted USD value.
* **24-Hour & 7-Day Volume**: Secondary market turnover.
* **Listed Ratio**: Percentage of total supply currently listed on secondary markets.
* **Unique Ownership**: Total unique holder count and concentration ratio.
* **Peak Call Multiplier**: Displays historical peak multiplier if this collection was previously called in the group.

### Example Invocation

```bash theme={null}
/nft pudgypenguins
```

### Response Format

```text theme={null}
🐧 Pudgy Penguins (Ethereum)

💵 Floor Price: 14.85 ETH ($39,204.00 USD)
📈 24h Volume: 142.50 ETH (+18.4%)
📦 Total Supply: 8,888 items
👥 Unique Owners: 4,821 (54% ratio)
🏷️ Listed: 284 (3.19% of supply)
🔗 https://opensea.io/collection/pudgypenguins
```

***

## `/ga-nfts` — Group NFT Floor ATH Leaderboard

Ranks community members by the highest floor price multiple (**X's**) achieved on NFT collections called inside the chat.

### How Group Alpha Tracking Works

```
1. Caller posts collection in chat ──> Clyr records Floor (0.05 ETH) & Caller Tag
2. Floor runs on secondary market ──> Sentinel records Peak Floor (0.35 ETH)
3. Member runs /ga-nfts          ──> Clyr ranks caller at 7.0x Multiplier
```

### Syntax

```bash theme={null}
/ga-nfts [timeframe]
```

**Aliases:** `/ath-nfts`, `/nft-ath`, `/nft-leaderboard`

### Parameters

| Parameter | Type | Required | Default | Supported Values |
| :- | :- | :- | :- | :- |
| `timeframe` | String | No | `30d` | `24h`, `7d`, `30d`, `all` |

### Leaderboard Output Format

```text theme={null}
🏆 Group NFT ATH Leaderboard (Past 30 Days)
Community: MANDEM 🫂❤️🦅

🥇 MoonCats Evolution
• Peak Multiplier: 4.25x 🔥 (Peak: 0.0850 ETH)
• Initial Call: 0.0200 ETH by @2348057416596
• Time to Peak: 3 days, 14 hours

🥈 Pudgy Penguins
• Peak Multiplier: 2.10x 🚀 (Peak: 17.8500 ETH)
• Initial Call: 8.5000 ETH by @Alex
• Time to Peak: 18 days, 2 hours

🥉 Kanpai Pandas
• Peak Multiplier: 1.85x ✨ (Peak: 1.4800 ETH)
• Initial Call: 0.8000 ETH by @DamiCrypto
• Time to Peak: 5 days, 8 hours
```

***

## `/mints` — Daily NFT Mint Radar

Fetches today's curated generative NFT drop schedule across Ethereum, Base, Solana, Arbitrum, and Polygon.

### Syntax

```bash theme={null}
/mints
```

**Aliases:** `/mint`, `/mint-radar`, `/mint-schedule`

### Schedule Card Data

* **Chain Badges**: Visual indicator of the target blockchain (`⟠ ETH`, `🔵 Base`, `◎ SOL`, `🔶 ARB`).
* **Supply & Mint Pricing**: Whitelist price vs. Public phase price.
* **Time Conversion**: Converted to West Africa Time (WAT) and UTC.
* **Direct Verification Links**: Clickable icons for official X account, OpenSea contract, Discord, and Whitelist checker.

### Response Sample

```text theme={null}
🎨 Today's Curated NFT Mints (14 Oct 2026)

1. CyberSamurai Gen-2 🔵 Base
• Supply: 3,333 | WL: Free | Public: 0.005 ETH
• Times: WL 2:00 PM WAT | Public 4:00 PM WAT
• Links: 🐦 x.com/cybersamurai | 🌊 opensea.io/...

2. SolGods Ascension ◎ Solana
• Supply: 2,000 | WL: 1.5 SOL | Public: 2.0 SOL
• Times: WL 5:00 PM WAT | Public 6:30 PM WAT
• Links: 🐦 x.com/solgods | 🌐 solgods.io
```

***

## `/mint-on` & `/mint-off` — Scheduled Mint Broadcasts

Controls whether Clyr automatically broadcasts the curated daily drop schedule into your group every morning at **08:00 WAT (07:00 UTC)**.

### Syntax

```bash theme={null}
/mint-on    # Enables daily morning drop broadcasts
/mint-off   # Mutes daily drop broadcasts
```

> [!NOTE]
>
> Enabling or disabling daily mint broadcasts requires **Group Administrator** privileges.

***

## `/nft-on` & `/nft-off` — OpenSea Link Unfurling

Controls whether Clyr automatically scans and posts market stats whenever a group member pastes an OpenSea URL into the chat.

### Syntax

```bash theme={null}
/nft-on     # Enables automatic OpenSea link unfurling
/nft-off    # Disables automatic link unfurling (silent mode)
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.