crypto-price – OpenClaw Skill

---

name: crypto-price description: Get cryptocurrency token price and generate candlestick charts via CoinGecko API or Hyperliquid API. Use when user asks for token price, crypto price, price chart, or cryptocurrency market data. metadata: {"clawdbot":{"emoji":"📈","requires":{"bins":["python3"]}}}

Crypto Price & Chart

Get cryptocurrency token price and generate candlestick charts.

Usage

Execute the script with token symbol and optional duration:

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

clawdhub install evgyur/crypto-price

Manual Installation

1. Clone or copy this skill to your Clawdbot workspace:

   cd ~/.clawdbot/workspace/skills
   git clone https://github.com/evgyur/crypto-price.git
   

2. Ensure Python 3 is installed:

   python3 --version
   

3. Install required Python packages:

   pip install matplotlib
   

4. Verify installation:

   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

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

Examples:

# 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:

{
  "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

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
• ClawdHub
• Clawdbot Documentation

Changelog

v1.0.0

• Initial release
• Support for CoinGecko and Hyperliquid APIs
• Candlestick chart generation
• Smart caching system
• Multiple timeframe support