← Back to Skills Marketplace
manifoldor

Crypto Market

by manifold · GitHub ↗ · v1.0.6 · MIT-0
cross-platform ✓ Security Clean
2779
Downloads
16
Stars
15
Active Installs
4
Versions
Install in OpenClaw
/install crypto
Description
Cryptocurrency market data and price alert monitoring tool based on CCXT. Supports multiple exchanges, real-time price tracking, and configurable price/volat...
README (SKILL.md)

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 - OKX
  • bybit - Bybit
  • gateio - Gate.io
  • kucoin - KuCoin
  • huobi - Huobi
  • coinbase - Coinbase
  • kraken - Kraken
  • bitfinex - 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 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

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

Usage Guidance
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 persistent state; (4) the skill does not require API keys, but if you elect to add keys for private actions, keep them secret and understand you’re enabling account-level operations; (5) the skill's source/homepage is not provided, so exercise standard caution (review code and run in a controlled environment if desired).
Capability Analysis
Type: OpenClaw Skill Name: crypto Version: 1.0.6 The skill is a legitimate cryptocurrency market monitoring tool that uses the well-known 'ccxt' library to fetch public market data. It provides functionality for tracking real-time prices, historical OHLCV data, and managing local price alerts stored in '~/.config/crypto/alerts.json'. The code in 'scripts/crypto.py' is well-structured, lacks any data exfiltration or remote execution capabilities, and strictly follows its stated purpose.
Capability Assessment
Purpose & Capability
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.
Instruction Scope
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.
Install Mechanism
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.
Credentials
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.
Persistence & Privilege
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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install crypto
  3. After installation, invoke the skill by name or use /crypto
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.6
- English documentation rewrite: All usage instructions and examples are now in English for broader accessibility. - Skill name updated from "crypto" to "Crypto Market" for greater clarity. - No functional or feature changes; all commands, usage, and alerts remain the same as previous versions. - Documentation structure improved for clearer presentation, including feature lists, troubleshooting, and use cases. - Descriptions, command examples, and tables translated and reformatted, ensuring information is consistent and up-to-date.
v1.0.5
- Initial release of the crypto skill. - Provides real-time cryptocurrency price tracking and configurable alerts based on the CCXT library. - Supports multiple exchanges (default: Binance) with quick exchange switching. - Features include live ticker, historical K-line data, order book, and customizable price/volatility alerts. - Command-line usage with flexible options for data retrieval and alert management.
v1.0.1
No significant changes detected in this version. - No file changes or user-visible updates were introduced. - All functionality and documentation remain unchanged from the previous version.
v1.0.0
- Initial release of the crypto skill. - Provides real-time cryptocurrency market data across multiple exchanges (default: Binance). - Supports price and volatility alerts with configurable conditions. - Includes commands for viewing tickers, historical price charts (K-lines), order books, and real-time monitoring. - Features alert management (add, remove, list, check) with persistent storage. - Offers flexible command-line options for exchange selection, timeframes, and refresh intervals.
Metadata
Slug crypto
Version 1.0.6
License MIT-0
All-time Installs 15
Active Installs 15
Total Versions 4
Frequently Asked Questions

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.

💬 Comments