/install crypto
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
pip3 install ccxt --user
Usage
Check Real-Time Prices
# 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- OKXbybit- Bybitgateio- Gate.iokucoin- KuCoinhuobi- Huobicoinbase- Coinbasekraken- Krakenbitfinex- Bitfinex
Get OHLCV (Candlestick) Data
# 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 minute5m- 5 minutes15m- 15 minutes1h- 1 hour4h- 4 hours1d- 1 day1w- 1 week1M- 1 month
View Order Book
python3 scripts/crypto.py orderbook BTC/USDT --limit 10
Live Price Monitoring
# 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:
# 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:
# 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
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 \x3C 3000 ⏳Monitoring
BTC/USDT_1706941400 BTC/USDT binance Rise > 5% ⏳Monitoring
Check Alerts
# 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
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
# 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
# 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
# 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
# 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
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install crypto - After installation, invoke the skill by name or use
/crypto - Provide required inputs per the skill's parameter spec and get structured output
What is Crypto Market?
Cryptocurrency market data and price alert monitoring tool based on CCXT. Supports multiple exchanges, real-time price tracking, and configurable price/volat... It is an AI Agent Skill for Claude Code / OpenClaw, with 2779 downloads so far.
How do I install Crypto Market?
Run "/install crypto" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Crypto Market free?
Yes, Crypto Market is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Crypto Market support?
Crypto Market is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Crypto Market?
It is built and maintained by manifold (@manifoldor); the current version is v1.0.6.