Ktrendz Lightstick Trading

# K-Trendz Lightstick Trading

Trade K-pop artist lightstick tokens on the K-Trendz bonding curve market.

**Capability Summary:** Buy and sell K-pop fan tokens with real-time pricing, news signals, and bonding curve mechanics. Early buyers benefit from price appreciation as artist popularity grows.

## Prerequisites

Run `/ktrendz:setup` first to configure your API key:

- **K-Trendz API Key** (required): Contact K-Trendz team for provisioning

You can also set via environment variable:
- `KTRENDZ_API_KEY`

## Quick Start

```bash
# Setup (one-time)
/ktrendz:setup

# Check token price
/ktrendz:price RIIZE

# Buy a token
/ktrendz:buy RIIZE

# Sell a token
/ktrendz:sell RIIZE
```

## 🎯 Decision Tree

- **"What's the price of X?"** → `/ktrendz:price <artist>`
- **"Should I buy X?"** → Check price + news signals first
- **"Buy X token"** → `/ktrendz:buy <artist>`
- **"Sell X token"** → `/ktrendz:sell <artist>`
- **"What tokens are available?"** → See Available Tokens below

## Main Commands

### /ktrendz:setup

Collects and validates API key, stores securely.

```bash
./scripts/setup.sh
```

### /ktrendz:price

Get current price and trading signals for a token.

```bash
./scripts/price.sh RIIZE
```

**Output includes:**
- Current price (USDC)
- Buy cost / Sell refund
- 24h price change
- Trending score
- Recent news signals

**Decision Factors:**

| Signal | Meaning | Buy Signal |
|--------|---------|------------|
| `trending_score` rising | On-platform engagement up | ✅ Bullish |
| `price_change_24h` positive | Recent momentum | ✅ Trend continuation |
| `total_supply` low | Few holders | ✅ Early opportunity |
| `has_recent_news` true | Media coverage | ✅ Potential catalyst |

### /ktrendz:buy

Purchase 1 lightstick token.

```bash
./scripts/buy.sh RIIZE
```

**Constraints:**
- Maximum 1 token per transaction (bonding curve protection)
- $100/day limit per agent
- Same-block trades blocked (MEV protection)

### /ktrendz:sell

Sell 1 lightstick token.

```bash
./sc...