crypto-price

# Crypto Price & Chart

Get cryptocurrency token price and generate candlestick charts.

## Usage

Execute the script with token symbol and optional duration:

```bash
python3 {baseDir}/scripts/get_price_chart.py <SYMBOL> [duration]
```

**Examples:**
- `python3 {baseDir}/scripts/get_price_chart.py HYPE`
- `python3 {baseDir}/scripts/get_price_chart.py HYPE 12h`
- `python3 {baseDir}/scripts/get_price_chart.py BTC 3h`
- `python3 {baseDir}/scripts/get_price_chart.py ETH 30m`
- `python3 {baseDir}/scripts/get_price_chart.py SOL 2d`

**Duration format:** `30m`, `3h`, `12h`, `24h` (default), `2d`

## Output

Returns JSON with:
- `price` - Current price in USD/USDT
- `change_period_percent` - Price change percentage for the period
- `chart_path` - Path to generated PNG chart (if available)
- `text_plain` - Formatted text description

**Chart as image (always when chart_path is present):**  
You must send the chart as a **photo**, not as text. In your reply, output `text_plain` and on a new line: `MEDIA: ` followed by the exact `chart_path` value (e.g. `MEDIA: /tmp/crypto_chart_HYPE_1769204734.png`). Clawdbot will attach that file as an image. Do **not** write `[chart: path]` or any other text placeholder — only the `MEDIA: <chart_path>` line makes the image appear.

## Chart Details

- Format: Candlestick chart (8x8 square)
- Theme: Dark (#0f141c background)
- Output: `/tmp/crypto_chart_{SYMBOL}_{timestamp}.png`

## Data Sources

1. **Hyperliquid API** - For HYPE and other Hyperliquid tokens (preferred)
2. **CoinGecko API** - Fallback for other tokens

Price data cached for 300 seconds (5 minutes) in `/tmp/crypto_price_*.json`.

# 📈 Crypto Price & Chart

A Clawdbot skill for fetching cryptocurrency token prices and generating beautiful candlestick charts.

## Features

- 🚀 **Fast price lookup** via CoinGecko and Hyperliquid APIs
- 📊 **Candlestick charts** with dark theme (8x8 square format)
- ⚡ **Smart caching** (5-minute TTL for price data)
- 🎯 **Multiple data sources** (Hyperliquid preferred for supported tokens, CoinGecko fallback)
- 📱 **Flexible timeframes** (30m, 3h, 12h, 24h, 2d)

## Installation

### Via ClawdHub

```bash
clawdhub install evgyur/crypto-price
```

### Manual Installation

1. Clone or copy this skill to your Clawdbot workspace:
   ```bash
   cd ~/.clawdbot/workspace/skills
   git clone https://github.com/evgyur/crypto-price.git
   ```

2. Ensure Python 3 is installed:
   ```bash
   python3 --version
   ```

3. Install required Python packages:
   ```bash
   pip install matplotlib
   ```

4. Verify installation:
   ```bash
   clawdbot skills info crypto-price
   ```

## Usage

### As a Skill

The skill is automatically triggered when users ask for:
- Token prices
- Crypto charts
- Cryptocurrency market data

### Direct Script Usage

```bash
python3 scripts/get_price_chart.py <SYMBOL> [duration]
```

**Examples:**
```bash
# Get HYPE price and 24h chart
python3 scripts/get_price_chart.py HYPE

# Get Bitcoin price and 12h chart
python3 scripts/get_price_chart.py BTC 12h

# Get Ethereum price and 3h chart
python3 scripts/get_price_chart.py ETH 3h

# Get Solana price and 30m chart
python3 scripts/get_price_chart.py SOL 30m

# Get Cardano price and 2d chart
python3 scripts/get_price_chart.py ADA 2d
```

### Duration Format

- `30m` - 30 minutes
- `3h` - 3 hours
- `12h` - 12 hours
- `24h` - 24 hours (default)
- `2d` - 2 days

## Output Format

The script returns JSON with the following structure:

```json
{
  "symbol": "BTC",
  "token_id": "bitcoin",
  "source": "coingecko",
  "currency": "USD",
  "hours": 24.0,
  "duration_label": "24h",
  "candle_minutes": 15,
  "price...