Initial commit with translated description

2026-03-29 09:42:39 +08:00
commit f9413f81d4
6 changed files with 1676 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,194 @@
+# 📈 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": 89946.00,
+  "price_usdt": 89946.00,
+  "change_period": -54.00,
+  "change_period_percent": -0.06,
+  "chart_path": "/tmp/crypto_chart_BTC_1769142011.png",
+  "text": "BTC: $89946.00 USD (-0.06% over 24h)",
+  "text_plain": "BTC: $89946.00 USD (-0.06% over 24h)"
+}
+```
+
+## Chart Generation
+
+- **Type**: Candlestick (OHLC)
+- **Size**: 8x8 inches (square format)
+- **Theme**: Dark (#121212 background)
+- **Colors** (default mode): 
+  - Grey (#B0B0B0 / #606060) normal candles
+  - Cyan (#00FFFF) bullish swing reversals (3 candles after swing low)
+  - Magenta (#FF00FF) bearish swing reversals (3 candles after swing high)
+  - Gold (#FFD54F) / Light Blue (#90CAF9) absolute high/low markers
+- **Colors** (gradient mode, add `gradient` flag): 
+  - Green gradient (#84dc58 → #336d16) bullish candles
+  - Blue-purple gradient (#6c7ce4 → #544996) bearish candles
+- **Features**:
+  - Fractal swing high/low detection (true pivots, configurable window)
+  - Volume bars (when available from API)
+  - Last price highlighted on Y-axis
+  - Tomorrow font for crisp rendering
+- **Output**: PNG files saved to `/tmp/crypto_chart_{SYMBOL}_{timestamp}.png`
+
+## Data Sources
+
+1. **Hyperliquid API** (`https://api.hyperliquid.xyz/info`)
+   - Preferred for HYPE and other Hyperliquid tokens
+   - Provides real-time price data and candlestick data
+
+2. **CoinGecko API** (`https://api.coingecko.com/api/v3/`)
+   - Fallback for all other tokens
+   - Supports price lookup, market charts, and OHLC data
+
+## Caching
+
+Price data is cached for 300 seconds (5 minutes) to reduce API calls:
+- Cache files: `/tmp/crypto_price_*.json`
+- Automatic cache invalidation after TTL
+
+## Supported Tokens
+
+Works with any token supported by CoinGecko or Hyperliquid:
+- **Popular tokens**: BTC, ETH, SOL, ADA, DOT, LINK, MATIC, AVAX, ATOM, ALGO, XLM, XRP, LTC, BCH, ETC, TRX, XMR, DASH, ZEC, EOS, BNB, DOGE, SHIB, UNI, AAVE
+- **Hyperliquid tokens**: HYPE, and other tokens listed on Hyperliquid
+
+## Requirements
+
+- Python 3.6+
+- `matplotlib` library
+- Internet connection for API calls
+
+## Dependencies
+
+```bash
+pip install matplotlib
+```
+
+## License
+
+MIT
+
+## Author
+
+Created for Clawdbot community. Originally part of Clawdbot bundled skills, restored and enhanced.
+
+## Contributing
+
+Contributions welcome! Please feel free to submit a Pull Request.
+
+## Related Skills
+
+This skill works with slash command skills:
+- `/hype` - HYPE token price and chart
+- `/token <SYMBOL>` - Any token price and chart
+- `/btc`, `/eth`, `/sol`, etc. - Popular tokens
+
+## Links
+
+- [GitHub Repository](https://github.com/evgyur/crypto-price)
+- [ClawdHub](https://clawdhub.com/evgyur/crypto-price)
+- [Clawdbot Documentation](https://docs.clawd.bot)
+
+## Changelog
+
+### v1.0.0
+- Initial release
+- Support for CoinGecko and Hyperliquid APIs
+- Candlestick chart generation
+- Smart caching system
+- Multiple timeframe support