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

# Financial & Market Commands

> Render high-resolution candlestick charts, generate GMGN/Axiom-style trading flex cards, and calculate live currency conversions.

## `/fc` — Financial Candlestick Chart

Fetches historical market data from institutional market feeds and renders a dark-mode candlestick chart accompanied by key market indicators.

```
┌────────────────────────────────────────────────────────┐
│  SOL/USD • 1h • Binance                $152.40 (+4.8%) │
│  High: $155.10  Low: $148.90  Vol: $1.2B               │
│                                                        │
│  [  High-Resolution Candlestick Graphic Rendered  ]    │
│  [        with Moving Averages & Volume Bars      ]    │
└────────────────────────────────────────────────────────┘
```

### Syntax

```bash theme={null}
/fc <ticker> [interval]
```

### Parameters

| Parameter | Type | Required | Default | Supported Values |
| :- | :- | :- | :- | :- |
| `ticker` | String | **Yes** | — | Asset ticker symbol (e.g. `BTC`, `SOL`, `ETH`, `BRETT`, `NVDA`, `USDNGN`) |
| `interval` | String | No | `1h` | `1m`, `5m`, `15m`, `1h`, `4h`, `1d` |

### Supported Asset Classes

* **Cryptocurrencies**: Major coins (`BTC`, `ETH`, `SOL`, `BNB`) and DEX-traded altcoins / memecoins.
* **Equities & Stocks**: US Equities via standard ticker (`AAPL`, `TSLA`, `NVDA`, `SPY`).
* **Foreign Exchange (Forex)**: Currency pairs (`EURUSD`, `GBPUSD`, `USDNGN`).

### Example Invocations

```bash theme={null}
/fc SOL        # Renders Solana 1-hour candlestick chart
/fc BTC 4h     # Renders Bitcoin 4-hour candlestick chart
/fc NVDA 1d    # Renders Nvidia daily candlestick chart
```

### Response Format

Clyr responds with a rich media message containing:

1. **Annotated Image Attachment**: High-resolution PNG chart with green/red candle bodies, EMA 20/50 overlays, and volume sub-bars.
2. **Text Summary Caption**:
   ```text theme={null}
   📊 SOL/USDT (1h)
   💵 Price: $152.40 (+4.82% 24h)
   📈 24h High: $155.10 | 📉 24h Low: $148.90
   📦 24h Volume: $1,248,500,210
   ```

***

## `/flex` — Token Trading Terminal Share Card

Generates an ultra-crisp, dark-emerald trading share card—designed in the visual style of GMGN, Axiom, and BullX—highlighting the peak performance multiplier of tokens called in your community.

### How Call Tracking & Multipliers Work

```
1. Member calls token in chat   ──>  Clyr logs Initial Market Cap ($250K) & Caller ID
2. Token rallies on DEX          ──>  Sentinel engine tracks peak price & logs ATH ($1.5M)
3. Member runs /flex <ticker>   ──>  Clyr renders 1200x630 share card with 6.0x (+500%) gain
```

### Syntax

```bash theme={null}
/flex [ticker]
```

**Aliases:** `/pnl`, `/brag`, `/card`, `/flex-card`

### Parameters

| Parameter | Type | Required | Default | Description |
| :- | :- | :- | :- | :- |
| `ticker` | String | No | Latest called token | Token symbol (e.g., `BRETT`, `POPCAT`, `BONK`). If omitted, pulls the most recent token called in the current group. |

### Visual Card Elements

The generated Canvas image (`1200x630` px) contains:

* **Token & Network Badge**: e.g., `$BRETT / WETH` with Base or Solana chain badge.
* **Massive Multiplier Callout**: Vivid emerald glow callout displaying the net gain: `+500.0% (6.0x)`.
* **Market Cap Progression**: Initial call market cap (`$250.0K`) vs. Peak ATH market cap reached (`$1.50M`).
* **Time to ATH**: Exact duration elapsed between the call and the peak price (e.g., `4h 12m`).
* **Caller Attribution**: Verified phone number or WhatsApp handle of the group member who first posted the token address.
* **Cryptographic Verification QR Code**: Scan code resolving to the Clyr on-chain ledger to verify the timestamp and proof of call.

### Example Invocation & Output

```bash theme={null}
/flex BRETT
```

```text theme={null}
🚀 ATH Flex Card Generated!
Token: BRETT (Base)
Called by: @2348057416596
Initial MC: $250.00K ──> Peak MC: $1.50M (6.0x 🔥)
Duration: 4 hours, 12 minutes
```

***

## `/flex-nft` — NFT Floor Trading Share Card

Renders a specialized trading share card for NFT collections called in your group, measuring initial called floor price against peak secondary market floor price.

### Syntax

```bash theme={null}
/flex-nft [slug]
```

**Aliases:** `/flexnft`, `/nft-flex`, `/nftflex`

### Parameters

| Parameter | Type | Required | Default | Description |
| :- | :- | :- | :- | :- |
| `slug` | String | No | Latest called NFT | OpenSea collection slug (e.g., `pudgypenguins`, `mooncats`). |

### Example Invocation

```bash theme={null}
/flex-nft mooncats
```

***

## `/rate` — Currency Exchange Rates

Retrieves real-time foreign exchange benchmarks, specifically tracking parallel market (P2P / Black Market) rates alongside official central bank rates for major trading corridors.

### Syntax

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

**Aliases:** `/rates`, `/fx`

### Response Format

```text theme={null}
💱 Live Currency Exchange Rates

💵 US Dollar (USD / NGN):
• Parallel (P2P / Black Market): ₦1,745.00
• Official (NAFEM / Bank): ₦1,680.50

💶 Euro (EUR / NGN):
• Parallel Market: ₦1,890.00

💷 British Pound (GBP / NGN):
• Parallel Market: ₦2,260.00

📊 Crypto Anchors:
• USDT / USD: $1.0002
• SOL / USD: $152.40
• ETH / USD: $2,640.10
```

***

## `/convert` — Multi-Currency & Token Converter

Converts any arbitrary amount between fiat currencies, cryptocurrencies, and stablecoins using live tick data.

### Syntax

```bash theme={null}
/convert <amount> <source_token> [target_token]
```

### Parameters

| Parameter | Type | Required | Default | Description |
| :- | :- | :- | :- | :- |
| `amount` | Number | **Yes** | — | Quantity to convert (supports prefix symbols like `$100` or `0.5`) |
| `source_token` | String | **Yes** | — | Asset to convert from (e.g., `eth`, `sol`, `btc`, `usd`, `ngn`) |
| `target_token` | String | No | Local currency or USD | Asset to convert into (defaults to `USD` or `NGN` depending on group region) |

### Examples

```bash theme={null}
/convert 0.5 eth
# Output: 0.5 ETH = $1,320.05 USD (₦2,303,487 NGN)

/convert $250 sol
# Output: $250 USD = 1.64 SOL

/convert 500000 ngn usdt
# Output: ₦500,000 NGN = 286.53 USDT
```


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