Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Professional Binance Dollar-Cost Averaging (DCA) tool for automated and manual recurring crypto purchases. Plan DCA strategies with scenario analysis, execute market/limit buys, track history, and manage systematic accumulation schedules for any trading pair. Includes risk management, testnet support, and OpenClaw automation integration. Triggers on requests about DCA, recurring buys, cost averaging, accumulation strategies, or Binance spot purchases.
Professional Binance Dollar-Cost Averaging (DCA) tool for automated and manual recurring crypto purchases. Plan DCA strategies with scenario analysis, execute market/limit buys, track history, and manage systematic accumulation schedules for any trading pair. Includes risk management, testnet support, and OpenClaw automation integration. Triggers on requests about DCA, recurring buys, cost averaging, accumulation strategies, or Binance spot purchases.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Systematic crypto accumulation made simple. Plan, execute, and track DCA strategies on Binance with confidence.
Dollar-Cost Averaging (DCA) is an investment strategy where you buy a fixed dollar amount of an asset at regular intervals, regardless of price. This approach: โ Reduces timing risk โ no need to predict market tops/bottoms โ Smooths volatility โ averages out price fluctuations over time โ Removes emotion โ systematic buying, no panic or FOMO โ Builds discipline โ consistent accumulation, perfect for long-term holders This tool helps you plan, automate, and track your DCA strategy on Binance spot markets.
๐ DCA Plan Projections โ scenario analysis showing potential outcomes at different price levels ๐ฐ Market & Limit Orders โ flexible execution options ๐ Trade History โ track your accumulation progress ๐ Secure โ credentials via environment variables only, zero hardcoded secrets ๐งช Testnet Support โ practice on Binance testnet before going live ๐ค OpenClaw Integration โ automate DCA buys via cron jobs with alerts ๐ก๏ธ Risk Management โ conservative defaults, validation before execution
Log in to binance.com Go to Account โ API Management Create a new API key: Label: OpenClaw-DCA (or similar) Restrictions: Enable Spot & Margin Trading only IP Whitelist: Add your server IP for security (optional but recommended) Save your API Key and Secret Key securely โ ๏ธ Security tips: Never share your secret key Enable IP whitelist if your server has a static IP Use a separate API key for DCA (easier to revoke if needed) Start with small amounts to test
Never hardcode credentials. Always use environment variables: export BINANCE_API_KEY="your-api-key-here" export BINANCE_SECRET_KEY="your-secret-key-here" Make them permanent (optional, add to ~/.bashrc or ~/.zshrc): echo 'export BINANCE_API_KEY="your-api-key-here"' >> ~/.bashrc echo 'export BINANCE_SECRET_KEY="your-secret-key-here"' >> ~/.bashrc source ~/.bashrc For testnet (recommended for first-time users): export BINANCE_BASE_URL="https://testnet.binance.vision" Get testnet API keys at: testnet.binance.vision
# Check balance (should not error) bash scripts/dca.sh balance USDT # Check BTC price bash scripts/dca.sh price BTCUSDT If you see prices/balances, you're ready!
bash scripts/dca.sh price BTCUSDT # Output: BTCUSDT = 95234.50 Works for any pair: bash scripts/dca.sh price ETHUSDT bash scripts/dca.sh price SOLUSDT
bash scripts/dca.sh balance USDT # Output: USDT: free=1000.00000000, locked=0.00000000 Check any asset: bash scripts/dca.sh balance BTC bash scripts/dca.sh balance ETH
Scenario: You want to invest $600 over 3 months in BTC. # $50 every week for 12 weeks bash scripts/dca.sh plan 50 7 12 BTCUSDT Output: DCA Plan: BTCUSDT ========================== Buy amount: $50 per buy Frequency: every 7 days Duration: 12 buys Current: 95234.50 ========================== Total invest: $600.00 At cur. price: 0.00630245 BTC Time span: 84 days (~2.8 months) Scenario Analysis (if avg price over period is): -30% -> avg $ 66,664.15 -> 0.00900000 BTC -> PnL: -$186.00 (-31.0%) -20% -> avg $ 76,187.60 -> 0.00787500 BTC -> PnL: -$126.00 (-21.0%) -10% -> avg $ 85,711.05 -> 0.00700000 BTC -> PnL: -$63.00 (-10.5%) +0% -> avg $ 95,234.50 -> 0.00630245 BTC -> PnL: +$0.00 (+0.0%) +10% -> avg $104,757.95 -> 0.00572727 BTC -> PnL: +$63.00 (+10.5%) +20% -> avg $114,281.40 -> 0.00525000 BTC -> PnL: +$126.00 (+21.0%) +50% -> avg $142,851.75 -> 0.00420000 BTC -> PnL: +$378.00 (+63.0%) +100% -> avg $190,469.00 -> 0.00315122 BTC -> PnL: +$630.00 (+105.0%) What this tells you: If BTC stays flat โ break even If BTC averages -20% during your buys โ you're down ~21% (but you own more BTC) If BTC averages +50% โ you're up ~63% Use this to set realistic expectations before committing.
Market order (instant execution): # Buy $50 worth of BTC at current market price bash scripts/dca.sh buy BTCUSDT 50 Output: Placing MARKET buy: BTCUSDT for 50 USDT... Order #123456789: FILLED Filled: 0.00052500 BTC Limit order (wait for your price): # Only buy if BTC drops to $94,000 bash scripts/dca.sh buy BTCUSDT 50 LIMIT 94000 Output: Placing LIMIT buy: BTCUSDT for 50 USDT... Order #123456790: NEW Filled: 0.00000000 BTC (Order will fill when price hits $94,000)
# Last 10 trades for BTCUSDT bash scripts/dca.sh history BTCUSDT 10 Output: Last 10 trades for BTCUSDT: --- 1738752000 | BUY | qty=0.00052500 | price=95238.10 | fee=0.00000053 BNB 1738665600 | BUY | qty=0.00051234 | price=97567.20 | fee=0.00000051 BNB ...
Get current spot price for a trading pair. bash scripts/dca.sh price BTCUSDT bash scripts/dca.sh price ETHUSDT bash scripts/dca.sh price SOLUSDT Default: BTCUSDT if symbol is omitted.
Check free and locked balance for an asset. bash scripts/dca.sh balance USDT bash scripts/dca.sh balance BTC bash scripts/dca.sh balance ETH Output format: ASSET: free=X.XXXXXXXX, locked=Y.YYYYYYYY Default: USDT if asset is omitted. Use case: Check how much capital you have available before placing orders.
Place a buy order. Arguments: SYMBOL โ Trading pair (e.g., BTCUSDT, ETHUSDT) AMOUNT โ Amount in quote currency (USDT). The tool calculates how much BTC/ETH you get. TYPE โ MARKET (default) or LIMIT PRICE โ Required for LIMIT orders Market order examples: # Buy $50 worth of BTC instantly bash scripts/dca.sh buy BTCUSDT 50 # Buy $100 worth of ETH instantly bash scripts/dca.sh buy ETHUSDT 100 Limit order examples: # Buy $50 BTC only if price drops to $90,000 bash scripts/dca.sh buy BTCUSDT 50 LIMIT 90000 # Buy $200 ETH only if price hits $3,200 bash scripts/dca.sh buy ETHUSDT 200 LIMIT 3200 Safety features: Amount validation (must be a number) API key check before execution Order status confirmation in output
Show recent trade history. # Last 10 trades for BTCUSDT bash scripts/dca.sh history BTCUSDT 10 # Last 20 trades for ETHUSDT bash scripts/dca.sh history ETHUSDT 20 # Last 50 trades for SOLUSDT bash scripts/dca.sh history SOLUSDT 50 Defaults: BTCUSDT, limit 10 Output includes: Timestamp (Unix seconds) Side (BUY/SELL) Quantity purchased Execution price Fees paid (and fee asset) Use case: Track your DCA progress over time, calculate average entry price.
Project a DCA plan with scenario analysis. Arguments: AMOUNT โ Dollar amount per buy (default: 50) FREQ_DAYS โ Days between buys (default: 7) NUM_BUYS โ Number of buys (default: 12) SYMBOL โ Trading pair (default: BTCUSDT) Examples: # Default plan: $50 every 7 days, 12 buys bash scripts/dca.sh plan # Aggressive: $200 every 3 days, 30 buys bash scripts/dca.sh plan 200 3 30 BTCUSDT # Conservative: $25 every 14 days, 24 buys bash scripts/dca.sh plan 25 14 24 BTCUSDT # ETH DCA: $100 weekly for 6 months bash scripts/dca.sh plan 100 7 26 ETHUSDT What you get: Total investment amount BTC/ETH you'd own at current price Time span (days + months) Scenario analysis: PnL at -30%, -20%, -10%, 0%, +10%, +20%, +50%, +100% average prices Use this to: Decide on a comfortable budget and frequency Understand risk/reward before starting Show the math to justify DCA vs. lump sum
โ Good for: Long-term accumulation (6+ months) High-volatility assets (BTC, ETH, altcoins) Building positions without timing stress Removing emotional decision-making โ Not ideal for: Short-term trading (use manual buys) Assets you want to flip quickly Low-volatility stablecoins (just buy once)
Start small โ Test with 1-2% of your budget first Use testnet โ Practice on https://testnet.binance.vision before going live Set a timeline โ DCA works best over 3-12+ months Stick to the plan โ Resist urge to stop during dips (that's when DCA shines) Track progress โ Use history to see your average entry price Adjust if needed โ Life changes, budgets change โ recalculate with plan and adapt
Conservative (1-2% per buy): Portfolio: $10,000 โ DCA $100-$200 per buy Lower risk, slower accumulation Moderate (3-5% per buy): Portfolio: $10,000 โ DCA $300-$500 per buy Balanced approach, standard for most users Aggressive (5-10% per buy): Portfolio: $10,000 โ DCA $500-$1,000 per buy Higher risk, faster accumulation, requires strong conviction Never go above 10% per buy โ leaves no room for unexpected dips or expenses.
Daily โ For very active traders, high time commitment Every 3 days โ Aggressive, good for short DCA periods (1-3 months) Weekly โ Most popular, good balance (Mondays are common) Bi-weekly โ Aligns with paychecks, moderate pace Monthly โ Long-term HODLers, lowest effort Pro tip: Match DCA frequency to your income schedule (weekly paycheck โ weekly DCA).
Run DCA buys automatically via system cron: # Every Monday at 9:00 AM UTC, buy $50 BTC 0 9 * * 1 BINANCE_API_KEY=... BINANCE_SECRET_KEY=... /path/to/dca.sh buy BTCUSDT 50 Limitations: No alerts if it fails No confirmations Silent execution
Use OpenClaw for intelligent DCA automation with alerts: Example: Weekly BTC DCA with Telegram notifications { "name": "Weekly BTC DCA", "schedule": { "kind": "cron", "expr": "0 9 * * 1", "tz": "America/New_York" }, "sessionTarget": "isolated", "payload": { "kind": "agentTurn", "message": "Execute weekly DCA: buy $50 BTCUSDT via binance-dca skill. After execution, send me a summary: amount bought, price, total BTC accumulated so far (check history). If it fails, alert me immediately.", "deliver": true, "channel": "telegram" } } Benefits: โ Execution confirmations sent to you โ Failure alerts โ Can ask agent to analyze history and report progress โ Easy to pause/resume via openclaw cron commands Setup: # Add the cron job (paste JSON above when prompted) openclaw cron add # List all jobs openclaw cron list # Run manually to test openclaw cron run <jobId> # Disable temporarily openclaw cron update <jobId> --enabled false
Fix: Set environment variables before running: export BINANCE_API_KEY="your-key" export BINANCE_SECRET_KEY="your-secret" bash scripts/dca.sh price
Cause: Your system clock is out of sync with Binance servers. Fix (Linux/macOS): # Sync system time sudo ntpdate -s time.nist.gov # Or install/enable NTP sudo systemctl enable systemd-timesyncd sudo systemctl start systemd-timesyncd Fix (Docker): Add --cap-add SYS_TIME when running container, or sync host clock.
Causes: Wrong BINANCE_SECRET_KEY API key restrictions (IP whitelist mismatch, disabled Spot Trading) Fix: Double-check your secret key (copy-paste from Binance) Verify API key has Spot & Margin Trading enabled If using IP whitelist, confirm your server IP is allowed Regenerate API key if uncertain
Causes: Network issues Wrong BINANCE_BASE_URL Binance API maintenance Fix: Test network: curl -I https://api.binance.com Check Binance status: binance.com/en/support/announcement If using testnet, confirm: export BINANCE_BASE_URL="https://testnet.binance.vision"
Cause: Not enough USDT in your spot account. Fix: Check balance: bash scripts/dca.sh balance USDT Deposit USDT to your spot account Reduce DCA amount to match available balance
This is normal for limit orders. Status means: NEW โ Order placed, waiting for price FILLED โ Order executed PARTIALLY_FILLED โ Partial execution CANCELED โ You or system canceled it Check order status: # View recent orders to see if it filled later bash scripts/dca.sh history BTCUSDT 20 Cancel pending limit orders: Use Binance web/app โ Orders โ Open Orders โ Cancel.
A: Yes! Use any Binance spot pair: bash scripts/dca.sh buy ETHUSDT 100 bash scripts/dca.sh buy SOLUSDT 50 bash scripts/dca.sh buy ADAUSDT 25 Just replace BTCUSDT with your desired pair.
A: Binance sets minimums per pair (usually $10-$20). Check Binance docs or test with a small amount on testnet first.
A: Not directly. Binance.US has a separate API (https://api.binance.us). You'd need to change BINANCE_BASE_URL and test. Not officially supported.
A: Not currently. This is DCA (accumulation) only. For selling, use Binance web/app or modify the script (change side=BUY to side=SELL).
A: No. Zero data storage. All credentials are environment variables. The script makes direct API calls to Binance and exits.
A: Yes, but set up API keys separately on each. Consider using IP whitelist on your API key for security.
A: Just adjust the amount in your next manual/cron execution. DCA is flexible โ no commitment to fixed amounts. Example: Week 1-4 use $50, Week 5+ use $100.
Run history and average the price column: bash scripts/dca.sh history BTCUSDT 50 | grep BUY | awk '{print $8}' | awk '{s+=$1; n++} END {print s/n}' Or use a spreadsheet: export history, paste prices, =AVERAGE().
๐ API Key Safety: Use dedicated API key for DCA (label it DCA-Only) Enable Spot Trading only (no Futures, Margin, Withdrawals) Set IP whitelist if your server has static IP Rotate keys every 3-6 months Revoke immediately if compromised ๐ Credential Management: Never commit .env files with keys to Git Use environment variables, not hardcoded strings On shared servers, restrict file permissions: chmod 600 ~/.bashrc ๐ Testnet First: Always test new strategies on testnet before using real funds Testnet keys: testnet.binance.vision Set: export BINANCE_BASE_URL="https://testnet.binance.vision" ๐ Start Small: First live DCA: use 10-20% of planned amount Verify execution, fees, and confirmations Scale up once confident
Adjust buy amounts based on price: Buy more when BTC dips: # If BTC < $90k, buy $100. Otherwise $50. CURRENT=$(bash scripts/dca.sh price BTCUSDT | awk '{print $3}') if (( $(echo "$CURRENT < 90000" | bc -l) )); then bash scripts/dca.sh buy BTCUSDT 100 else bash scripts/dca.sh buy BTCUSDT 50 fi Use limit orders to "buy the dip": # Place limit orders 5%, 10%, 15% below current price PRICE=$(bash scripts/dca.sh price BTCUSDT | awk '{print $3}') LIMIT_5=$(echo "$PRICE * 0.95" | bc) LIMIT_10=$(echo "$PRICE * 0.90" | bc) LIMIT_15=$(echo "$PRICE * 0.85" | bc) bash scripts/dca.sh buy BTCUSDT 50 LIMIT $LIMIT_5 bash scripts/dca.sh buy BTCUSDT 50 LIMIT $LIMIT_10 bash scripts/dca.sh buy BTCUSDT 50 LIMIT $LIMIT_15
DCA into multiple coins: # Weekly: $30 BTC, $20 ETH, $10 SOL bash scripts/dca.sh buy BTCUSDT 30 bash scripts/dca.sh buy ETHUSDT 20 bash scripts/dca.sh buy SOLUSDT 10
Track all DCA buys to a log file: #!/bin/bash LOGFILE="$HOME/dca-log.txt" DATE=$(date '+%Y-%m-%d %H:%M:%S') bash scripts/dca.sh buy BTCUSDT 50 | tee -a "$LOGFILE" echo "[$DATE] DCA executed" >> "$LOGFILE" Then analyze with: grep "Filled:" ~/dca-log.txt
Found a bug? Have a feature idea? Want to add support for other exchanges? GitHub: (if public repo exists, link here) Issues: Report via GitHub Issues Pull Requests: Welcome! Follow existing code style.
MIT License โ Free to use, modify, and distribute. Disclaimer: This tool is provided as-is. Use at your own risk. The authors are not responsible for trading losses, API issues, or incorrect usage. Always test on testnet first and never invest more than you can afford to lose.
๐ Comprehensive documentation overhaul ๐ Added real-world examples for all actions ๐ DCA strategy guide with best practices ๐ง Troubleshooting section โ FAQ with common questions ๐ Security best practices guide ๐ Advanced usage examples ๐ค OpenClaw automation guide
Initial public release Core DCA functionality: plan, buy, history, price, balance Testnet support Market and limit orders Built with โค๏ธ for long-term crypto accumulation. Questions? Feedback? Tag @fpsjago on ClawHub or OpenClaw Discord.
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.