Clawhub Skills

# K-Trendz Lightstick Trading Skill

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

## Overview

K-Trendz Lightsticks are digital fan tokens tied to K-pop artists. Unlike arbitrage markets, this is a **bonding curve** system where:
- **Price increases with each purchase** (√supply formula)
- **Artist popularity directly affects demand**
- **Early buyers benefit from price appreciation**

## Trading Strategy Context

This is NOT an arbitrage market. Key principles:
1. **Buy when trending** - Rising `trending_score` and recent news indicate growing demand
2. **Buy early** - Lower `total_supply` means earlier position on the curve
3. **Monitor external signals** - News headlines often precede on-platform activity
4. **Hold during growth** - Bonding curve rewards patient holders

## Available Tools

### get_token_price

Get current price and popularity signals for a token.

**Endpoint**: `POST /functions/v1/bot-get-token-price`

**Headers**:
```
x-bot-api-key: YOUR_API_KEY
Content-Type: application/json
```

**Request**:
```json
{
  "token_id": "7963681970480434413",
  // OR
  "artist_name": "RIIZE"
}
```

**Response**:
```json
{
  "success": true,
  "data": {
    "token_id": "7963681970480434413",
    "artist_name": "RIIZE",
    "current_price_usdc": 1.85,
    "buy_cost_usdc": 1.91,
    "sell_refund_usdc": 1.78,
    "price_change_24h": "+5.2",
    "total_supply": 42,
    "trending_score": 1250,
    "votes": 89,
    "follower_count": 156,
    "view_count": 2340,
    "external_signals": {
      "article_count_24h": 3,
      "headlines": [
        {"title": "RIIZE announces world tour dates", "url": "..."},
        {"title": "New single breaks records", "url": "..."}
      ],
      "has_recent_news": true
    },
    "trading_context": {
      "contract_address": "0xfe7791e3078FD183FD1c08dE2F1e4ab732024489",
      "fee_structure": {
        "buy_fee_percent": 3,
        "sell_fee_percent": 2
      }
    }
  }
}
```

**Decision Factors**:
| Fiel...