← Back to Skills Marketplace
dymx101

Clap Trader

by dymx101 · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
792
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install clap-trader
Description
A skill for OpenClaw to research crypto market trends (technical & sentiment) and trade ETH on Binance.
README (SKILL.md)

Crypto Trader & Analyst Skill

This skill allows OpenClaw to analyze the crypto market using technical indicators and news sentiment, record its findings, and execute trades on Binance.

Dependencies

Ensure the following Python packages are installed:

pip install ccxt pandas pandas-ta requests TextBlob

Note: TextBlob is suggested for basic sentiment analysis if needed, though simple keyword matching might suffice.

Environment Variables

You must set the following environment variables for trading:

  • BINANCE_API_KEY: Your Binance API Key.
  • BINANCE_API_SECRET: Your Binance API Secret.

WARNING: Never share these keys or commit them to version control.

Workflow

1. Market Analysis

Technical Analysis Run the market data script to get current indicators for a symbol (default ETH/USDT).

python skills/crypto_trader/scripts/market_data.py --symbol ETH/USDT

Output: JSON containing RSI, MACD, close price, etc.

Sentiment Analysis Run the sentiment script to fetch latest news headers and forum buzz.

python skills/crypto_trader/scripts/sentiment_data.py

Output: Text/JSON summary of positive/negative news.

2. Decision Making & Logging

Analyze & Record Based on the outputs from step 1, form a hypothesis. Is the market Bullish, Bearish, or Neutral? Before trading, you MUST save your analysis.

python skills/crypto_trader/scripts/logger.py "Your detailed analysis here. E.g., RSI is 30 (oversold) and news is positive. Planning to BUY."

3. Execution

Trade If the analysis supports a trade, execute it.

# Buy 0.01 ETH at Market Price
python skills/crypto_trader/scripts/trade.py --symbol ETH/USDT --side buy --amount 0.01 --type market

# Dry Run (Test without real money)
python skills/crypto_trader/scripts/trade.py --symbol ETH/USDT --side buy --amount 0.01 --dry-run

The trade script will automatically append the transaction to skills/crypto_trader/logs/trade_history.csv.

Files structure

  • scripts/market_data.py: Fetches OHLCV and calculates indicators.
  • scripts/sentiment_data.py: Fetches news/forum data.
  • scripts/logger.py: Appends analysis to logs/analysis_journal.md.
  • scripts/trade.py: Executes trades and logs to logs/trade_history.csv.
  • logs/: Directory storing your analysis history and trade logs.
Usage Guidance
This skill appears to do what it says (market analysis + Binance trading), but there are clear inconsistencies you should address before running with real funds: 1) Do not provide your live BINANCE_API_KEY/BINANCE_API_SECRET until you confirm the packaging and paths — the registry metadata omitted these env vars and script paths in SKILL.md don't match the included files. 2) Inspect the code yourself (or have someone you trust review it). 3) When testing, use dry-run mode and/or a Binance testnet key with restricted permissions (disable withdrawals, limit IPs) and small amounts. 4) Run the skill in an isolated environment (container or VM) so logs and any files are contained. 5) Ensure the logs directory paths exist or correct the paths to where you intend logs to be written. If you cannot verify the author/source or fix the metadata/path issues, treat the skill as untrusted and avoid supplying real credentials.
Capability Analysis
Type: OpenClaw Skill Name: clap-trader Version: 1.0.0 The skill bundle provides functionality for crypto market analysis and trading on Binance, which aligns with its stated purpose. It requires Binance API keys from environment variables, which is standard practice for sensitive credentials. The `SKILL.md` provides clear instructions for the AI agent and includes a warning about API key security. All scripts (`market_data.py`, `sentiment_data.py`, `logger.py`, `trade.py`) perform actions directly related to the skill's description, such as fetching market data, analyzing sentiment, logging analysis, and executing trades (with a `--dry-run` option). There is no evidence of intentional harmful behavior, data exfiltration to unauthorized endpoints, persistence mechanisms, obfuscation, or malicious prompt injection attempts within the skill's own instructions or code.
Capability Assessment
Purpose & Capability
The scripts (market_data, sentiment_data, logger, trade) implement the advertised functionality (indicators, RSS sentiment, logging, Binance trades). However the registry metadata declares no required environment variables or credentials while the SKILL.md and trade.py clearly require BINANCE_API_KEY and BINANCE_API_SECRET. That mismatch between declared requirements and actual code is incoherent and should be corrected/clarified by the author.
Instruction Scope
SKILL.md instructions are specific and align with the skill's purpose (how to run analysis, log, and execute trades). They instruct fetching external RSS feeds and making network calls to Binance via ccxt — expected for this functionality. Concerns: the SKILL.md command paths use 'skills/crypto_trader/scripts/...' but the distributed manifest lists scripts at top-level 'scripts/...'; log paths in code point to 'skills/crypto_trader/logs/...'. These path inconsistencies can lead to runtime errors or unexpected file creation locations.
Install Mechanism
There is no install spec (instruction-only install), which is lower risk. The README asks users to pip install common packages (ccxt, pandas, pandas-ta, requests, TextBlob) — reasonable for Python-based analysis/trading. No downloads from untrusted URLs or obfuscated installers were found.
Credentials
The only sensitive credentials used by the code are BINANCE_API_KEY and BINANCE_API_SECRET, which are appropriate for Binance trading. However the skill registry metadata omitted these required env vars; that omission is concerning because users may not realize they must provide API keys. No other unrelated credentials are requested.
Persistence & Privilege
The skill does write logs/trade history to local files under a 'logs' path, which is normal for a trading tool. It does not request always:true or modify other skills or system-wide settings. Autonomous invocation is allowed by default but not combined with elevated privileges here.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install clap-trader
  3. After installation, invoke the skill by name or use /clap-trader
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the Crypto Trader & Analyst skill for OpenClaw: - Enables technical and sentiment analysis of crypto markets, focusing on ETH/USDT. - Provides scripts for market data retrieval, sentiment analysis, structured analysis logging, and Binance trading execution. - Includes guidance on required dependencies, environment variable setup, and safe trading practices. - Automated logging for all market analyses and trade transactions.
Metadata
Slug clap-trader
Version 1.0.0
License
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Clap Trader?

A skill for OpenClaw to research crypto market trends (technical & sentiment) and trade ETH on Binance. It is an AI Agent Skill for Claude Code / OpenClaw, with 792 downloads so far.

How do I install Clap Trader?

Run "/install clap-trader" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Clap Trader free?

Yes, Clap Trader is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Clap Trader support?

Clap Trader is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Clap Trader?

It is built and maintained by dymx101 (@dymx101); the current version is v1.0.0.

💬 Comments