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.
Install
Documentation
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
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
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.
Launch an agent with Crypto Price on Termo.