KTrendz Lightstick Trading

- **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
./scripts/sell.sh RIIZE
```

## Available Tokens

| Artist | Token ID |
|--------|----------|
| K-Trendz Supporters | 12666454296509763493 |
| RIIZE | 7963681970480434413 |
| IVE | 4607865675402095874 |
| Cortis | 13766662462343366758 |
| BTS | 9138265216282739420 |
| All Day Project | 18115915419890895215 |

## Trading Strategy

This is a **bonding curve** market, not arbitrage:

1. **Buy when trending** - Rising scores + news = growing demand
2. **Buy early** - Lower supply = better curve position
3. **Monitor signals** - News often precedes on-platform activity
4. **Hold during growth** - Bonding curve rewards patient holders

## Fee Structure

| Action | Fee | Distribution |
|--------|-----|--------------|
| Buy | 3% | 2% Artist Fund, 1% Platform |
| Sell | 2% | Platform |

**Round-trip cost:** 5%

## Rate Limits

- **Daily Volume:** $100 USD per agent
- **Transaction Frequency:** Max 100 trades/day
- **Circuit Breaker:** Pauses if price moves >20% in 10 blocks

## Example Interactions

**User:** "What's RIIZE trading at?"

**You:**
1. Run `./scripts/price.sh RIIZE`
2. Report: "RIIZE is at $1.85 (+5.2% 24h). Trending score 1250 with 3 recent news articles. Buy cost: $1.91"

**User:** "Buy RIIZE for me"

**You:**
1. Confirm: "Buy 1 RIIZE token for ~$1.91?"
2. If yes, run `./scripts/buy.sh RIIZE`
3. Report: "Purchased 1 RIIZE for $1.91. Tx: 0x..."

**User:** "Should I sell my IVE?"

**You:**
1. Run `./scripts/price.sh IVE`
2. Check signals (price trend, news, trending score)
3. Advise based on data

## API Reference

Base URL: `https://k-trendz.com/api/bot/`

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/token-price` | POST | Get price + signals |
| `/buy` | POST | Purchase 1 token |
| `/sell` | POST | Sell 1 token |

## Files

- `SKILL.md` - This file
- `package.json` - Package metadata
- `scripts/setup.sh` - API key configuration
- `scripts/price.sh` - Get token price
- `scripts/buy.sh` - Buy token
- `scripts/sell.sh` - Sell token