Crypto Chart

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.

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): In OpenClaw, send the image via message tool (not plain text placeholder):

1. Copy from /tmp to workspace: cp <chart_path> ./crypto_chart_<SYMBOL>_<duration>.png
2. Send: message(action="send", filePath="./crypto_chart_<SYMBOL>_<duration>.png", message="<text_plain>")
3. MANDATORY cleanup — run both commands regardless of send result:
   • rm ./crypto_chart_<SYMBOL>_<duration>.png
   • rm <chart_path>
4. 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

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.