- name
- crypto-chart
- 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
- {"openclaw":{"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 HYPEpython3 {baseDir}/scripts/get_price_chart.py HYPE 12hpython3 {baseDir}/scripts/get_price_chart.py BTC 3hpython3 {baseDir}/scripts/get_price_chart.py ETH 30mpython3 {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/USDTchange_period_percent- Price change percentage for the periodchart_path- Path to generated PNG chart (if available)text_plain- Formatted text description
Chart as image (always when chart_path is present): In OpenClaw, send the image via message tool (not plain text placeholder):
- Copy from
/tmpto workspace:cp <chart_path> ./crypto_chart_<SYMBOL>_<duration>.png - Send:
message(action="send", filePath="./crypto_chart_<SYMBOL>_<duration>.png", message="<text_plain>") - MANDATORY cleanup — run both commands regardless of send result:
- rm ./crypto_chart_<SYMBOL>_<duration>.png - rm <chart_path>
- Reply
NO_REPLY.
Do not skip step 3. Files left in workspace accumulate and waste disk space.
Chart Details
- Format: Candlestick chart (8x8 square)
- Theme: Dark (#0f141c background)
- Output:
/tmp/crypto_chart_{SYMBOL}_{timestamp}.png
Data Sources
- Hyperliquid API - For HYPE and other Hyperliquid tokens (preferred)
- CoinGecko API - Fallback for other tokens
Price data cached for 300 seconds (5 minutes) in /tmp/crypto_price_*.json.