Crypto Market — 技能 — openclaw中文资讯站

技能详情（站内镜像，无评论）

Cryptocurrency market data and price alert monitoring tool based on CCXT. Supports multiple exchanges, real-time price tracking, and configurable price/volat...

数据与表格

作者：linyishan @AlphaFactor

许可证：MIT-0

MIT-0 ·免费使用、修改和重新分发。无需归因。

版本：v1.0.6

统计：⭐ 13 · 2k · 11 current installs · 11 all-time installs

⭐ 13

安装量（当前） 11

🛡 VirusTotal ：良性 · OpenClaw ：良性

Package：alphafactor/crypto

安全扫描（ClawHub）

VirusTotal ：良性
OpenClaw ：良性

OpenClaw 评估

The skill's code, instructions, and requirements align with its stated purpose (CCXT-based market data and alerts); it makes network calls to exchanges and stores alerts locally but does not request unrelated credentials or perform unexpected actions.

目的

Name/description match the included Python script and SKILL.md. The script uses CCXT to fetch market data, OHLCV, and order books and implements local alert management — all coherent with a crypto market/alert tool.

说明范围

SKILL.md only instructs installing ccxt and running the included script with explicit commands. The runtime instructions do not ask the agent to read unrelated system files or transmit data to unintended endpoints. The script performs network calls only to exchange APIs via CCXT.

安装机制

This is an instruction-only skill with no install spec. SKILL.md recommends pip installing ccxt (a standard public package). No downloads from untrusted URLs or archive extraction are present.

证书

The skill declares no required env vars or credentials. The code uses public CCXT endpoints by default and does not read extraneous environment variables. The documentation notes how API keys could be used for private endpoints (typical for CCXT) — supplying keys would be optional and should be done cautiously by the user.

持久

The script persists alerts locally under ~/.config/crypto/alerts.json. 'always' is false and the skill does not modify other skills or global agent settings. Local persistence is expected for an alerts tool, but users should be aware of the file location and content.

综合结论

This skill appears to do what it says: fetch public market data via CCXT and manage local price alerts. The included Python source is readable and matches the documentation. Before installing or running: (1) inspect the script (it's included) if you have concerns; (2) note it will make outbound network requests to exchange APIs (normal for market data); (3) it stores alerts in ~/.config/crypto/alerts.json — remove that file if you want no pers…

安装（复制给龙虾 AI）

将下方整段复制到龙虾中文库对话中，由龙虾按 SKILL.md 完成安装。

请把本段交给龙虾中文库（龙虾 AI）执行：为本机安装 OpenClaw 技能「Crypto Market」。简介：Cryptocurrency market data and price alert monitoring tool based on CCXT. Suppo…。
请 fetch 以下地址读取 SKILL.md 并按文档完成安装：https://raw.githubusercontent.com/openclaw/skills/refs/heads/main/skills/alphafactor/crypto/SKILL.md
（来源：yingzhi8.cn 技能库）

SKILL.md

打开原始 SKILL.md（GitHub raw）

---
name: Crypto Market
slug: crypto
description: Cryptocurrency market data and price alert monitoring tool based on CCXT. Supports multiple exchanges, real-time price tracking, and configurable price/volatility alerts. Use when the user needs to monitor crypto prices or set up trading alerts. Default exchange is Binance.
---

# Cryptocurrency Market & Price Alerts

A cryptocurrency market data fetching and price monitoring tool based on the CCXT library. It supports multiple exchanges, real-time monitoring, and smart alerts.

## Features

- 🏢 **Multi-Exchange Support** - Defaults to Binance. Also supports OKX, Bybit, Gate.io, KuCoin, etc.
- 📊 **Real-time Market Data** - Get the latest prices, price changes, volumes, and more.
- 📈 **OHLCV Data (Candlesticks)** - Fetch historical price trends.
- 📖 **Order Book** - View market depth (bids and asks).
- 🔔 **Price Alerts** - Supports price thresholds and percentage change alerts.
- 👁️ **Live Monitoring** - Continuously monitor price movements.

## Prerequisites

### Install Dependencies

```bash
pip3 install ccxt --user
```

## Usage

### Check Real-Time Prices

```bash
# Default (Binance)
python3 scripts/crypto.py ticker BTC/USDT

# Use other exchanges
python3 scripts/crypto.py -e okx ticker ETH/USDT
python3 scripts/crypto.py -e bybit ticker BTC/USDT
```

**Supported Exchanges**:
- `binance` - Binance (Default)
- `okx` - OKX
- `bybit` - Bybit
- `gateio` - Gate.io
- `kucoin` - KuCoin
- `huobi` - Huobi
- `coinbase` - Coinbase
- `kraken` - Kraken
- `bitfinex` - Bitfinex

### Get OHLCV (Candlestick) Data

```bash
# Get 1-hour candles, last 24 periods
python3 scripts/crypto.py ohlcv BTC/USDT --timeframe 1h --limit 24

# Get daily candles, last 30 periods
python3 scripts/crypto.py ohlcv ETH/USDT --timeframe 1d --limit 30
```

**Timeframes**:
- `1m` - 1 minute
- `5m` - 5 minutes
- `15m` - 15 minutes
- `1h` - 1 hour
- `4h` - 4 hours
- `1d` - 1 day
- `1w` - 1 week
- `1M` - 1 month

### View Order Book

```bash
python3 scripts/crypto.py orderbook BTC/USDT --limit 10
```

### Live Price Monitoring

```bash
# Refresh every 10 seconds (default)
python3 scripts/crypto.py watch BTC/USDT

# Refresh every 5 seconds
python3 scripts/crypto.py watch ETH/USDT --interval 5
```

## Price Alerts

### Add Alerts

**Price Threshold Alerts:**
```bash
# Alert when BTC price breaks above 70000 USDT
python3 scripts/crypto.py alert-add BTC/USDT above 70000

# Alert when ETH price drops below 3000 USDT
python3 scripts/crypto.py alert-add ETH/USDT below 3000
```

**Percentage Change Alerts:**
```bash
# Alert when BTC rises more than 5%
python3 scripts/crypto.py alert-add BTC/USDT up_percent 5

# Alert when ETH drops more than 3%
python3 scripts/crypto.py alert-add ETH/USDT down_percent 3
```

### View Alert List

```bash
python3 scripts/crypto.py alert-list
```

Example Output:
```
🔔 Price Alerts (3):

ID                        Pair            Exchange     Condition                 Status
------------------------------------------------------------------------------------------
BTC/USDT_1706941200       BTC/USDT        binance      Price > 70000             ⏳Monitoring
ETH/USDT_1706941300       ETH/USDT        okx          Price < 3000              ⏳Monitoring
BTC/USDT_1706941400       BTC/USDT        binance      Rise > 5%                 ⏳Monitoring
```

### Check Alerts

```bash
# Manually check all alert conditions
python3 scripts/crypto.py alert-check
```

When a condition is triggered, it shows:
```
⚠️  Triggered 1 alert:

  🚀 BTC/USDT rose by 5.23%, current price: 71234.56
  Alert ID: BTC/USDT_1706941400
```

### Remove Alerts

```bash
python3 scripts/crypto.py alert-remove BTC/USDT_1706941200
```

## Command Reference

| Command | Function | Example |
|------|------|------|
| `ticker` | Real-time prices | `ticker BTC/USDT` |
| `ohlcv` | Candlestick data | `ohlcv BTC/USDT --timeframe 1h` |
| `orderbook` | Order book | `orderbook BTC/USDT` |
| `watch` | Live monitoring | `watch BTC/USDT --interval 5` |
| `alert-add` | Add an alert | `alert-add BTC/USDT above 70000` |
| `alert-remove` | Remove an alert | `alert-remove ID` |
| `alert-list` | List alerts | `alert-list` |
| `alert-check` | Check alerts | `alert-check` |

### Global Arguments

| Argument | Short | Description | Default |
|------|------|------|--------|
| `--exchange` | `-e` | Exchange name | `binance` |
| `--timeframe` | `-t` | Candlestick timeframe | `1h` |
| `--limit` | `-l` | Data limit (count) | `24` |
| `--interval` | `-i` | Refresh interval (sec) | `10` |

## Alert Conditions

| Condition | Description | Example |
|------|------|------|
| `above` | Price goes above threshold | `above 70000` |
| `below` | Price drops below threshold | `below 3000` |
| `up_percent` | Price rises by % | `up_percent 5` |
| `down_percent` | Price drops by % | `down_percent 3` |

## Use Cases

### Scenario 1: Tracking specific price targets
```bash
# Alert when BTC breaks previous high
python3 scripts/crypto.py alert-add BTC/USDT above 69000

# Regularly check
python3 scripts/crypto.py alert-check
```

### Scenario 2: Monitoring support/resistance levels
```bash
# ETH drops below key support
python3 scripts/crypto.py alert-add ETH/USDT below 2800

# BTC breaks resistance
python3 scripts/crypto.py alert-add BTC/USDT above 72000
```

### Scenario 3: Volatility monitoring
```bash
# Monitor massive volatility
python3 scripts/crypto.py alert-add BTC/USDT up_percent 8
python3 scripts/crypto.py alert-add BTC/USDT down_percent 8
```

### Scenario 4: Cross-exchange price comparison
```bash
# Check prices across different exchanges
python3 scripts/crypto.py -e binance ticker BTC/USDT
python3 scripts/crypto.py -e okx ticker BTC/USDT
python3 scripts/crypto.py -e bybit ticker BTC/USDT
```

## Troubleshooting

**Error: ccxt library not installed**
→ Run: `pip3 install ccxt --user`

**Error: Unsupported exchange**
→ Check exchange spelling. Refer to the supported exchanges list.

**Error: Trading pair does not exist**
→ Check trading pair format, e.g., `BTC/USDT`, `ETH/USDT`.

**Alert not triggering**
→ Confirm alert conditions are correct. Run `alert-check` to check manually.

**API Limits**
→ Some exchanges have strict rate limits. Use `--interval` to adjust the refresh frequency.

## Configuration File

Alert configurations are stored at: `~/.config/crypto/alerts.json`

You can manually edit this file to batch manage your alerts.

## References

- CCXT Documentation: https://docs.ccxt.com/
- Supported Exchanges List: [references/exchanges.md](references/exchanges.md)