51 lines
1.9 KiB
Markdown
51 lines
1.9 KiB
Markdown
---
|
|
name: crypto-price
|
|
description: "通过CoinGecko API或Hyperliquid API获取加密货币代币价格并生成K线图。当用户询问代币价格、加密货币价格、价格图表或加密货币市场数据时使用。"
|
|
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:
|
|
|
|
```bash
|
|
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`.
|