Aicoin Freqtrade

AiCoin Freqtrade

Freqtrade strategy creation, backtesting, and deployment powered by AiCoin Open API.

Version: 1.0.0

STRATEGY CREATION — USE create_strategy

You MUST use create_strategy to generate strategy files. NEVER write Python strategy code by hand.

# Generate a strategy with AiCoin data
node scripts/ft-deploy.mjs create_strategy '{"name":"MyStrategy","timeframe":"15m","aicoin_data":["funding_rate","ls_ratio"],"description":"资金费率极端做反向"}'

# Generate a pure technical strategy (no AiCoin data)
node scripts/ft-deploy.mjs create_strategy '{"name":"SimpleRSI","timeframe":"1h"}'

aicoin_data options (combine any):

Strategy Generation Rules for Agent

All aicoin_data options require a paid API key. Based on the user's strategy description:

• If strategy needs AiCoin data (funding_rate, ls_ratio, big_orders, open_interest, liquidation_map):
  1. Do NOT silently include it. First inform the user that this data requires a paid API key.
  2. Tell them which tier is needed (see table above).
  3. Guide them: get API key at https://www.aicoin.com/opendata → add AICOIN_ACCESS_KEY_ID & AICOIN_ACCESS_SECRET to .env.
  4. Only include the paid data after user confirms they have the key configured.
• If strategy does NOT need AiCoin data: Generate a pure technical indicator strategy (RSI, EMA, Bollinger, etc.) — works for everyone out of the box.

After generating, backtest immediately:

node scripts/ft-deploy.mjs backtest '{"strategy":"MyStrategy","timeframe":"15m","timerange":"20250101-20260301"}'

Critical Rules

1. ALWAYS use create_strategy to write strategies. NEVER hand-write Python strategy files.
2. ALWAYS use ft-deploy.mjs backtest for backtesting. NEVER write custom Python backtest scripts.
3. ALWAYS use ft-deploy.mjs deploy for deployment. NEVER use Docker. NEVER manually run freqtrade commands.
4. NEVER manually edit Freqtrade config files. Use ft-deploy.mjs actions.
5. NEVER manually run freqtrade trade, source .venv/bin/activate, or pip install freqtrade.

Quick Reference

Setup

Prerequisites: Python 3.11+ and git.

Environment Variables

.env auto-loaded from (first found wins):

1. Current working directory
2. ~/.openclaw/workspace/.env
3. ~/.openclaw/.env

Exchange keys (required for live/dry-run trading):

# Same format as aicoin-trading skill
BINANCE_API_KEY=xxx
BINANCE_API_SECRET=xxx
# Or OKX, Bybit, etc. — see aicoin-trading skill for full list

AiCoin API key (required if strategy uses aicoin_data):

AICOIN_ACCESS_KEY_ID=your-key-id
AICOIN_ACCESS_SECRET=your-secret

Get at https://www.aicoin.com/opendata. See Paid Feature Guide for tier details.

安全说明： AiCoin API Key 仅用于获取市场数据，无法进行任何交易操作。交易所 API Key 需单独到交易所申请。所有密钥仅保存在本地设备 .env 文件中，不会上传到任何服务器。

Deploy

Deploy is one command:

node scripts/ft-deploy.mjs check    # Check prerequisites
node scripts/ft-deploy.mjs deploy '{"pairs":["BTC/USDT:USDT","ETH/USDT:USDT"]}'

This automatically: clones Freqtrade, runs setup.sh -i, creates config from .env, starts background process, writes FREQTRADE_* vars to .env.

Deploy defaults to dry-run (simulated trading). Pass {"dry_run":false} for live.

Scripts

scripts/ft-deploy.mjs — Deployment & Strategy

scripts/ft.mjs — Bot Control (requires running process)

scripts/ft-dev.mjs — Dev Tools (requires running process)

Built-in AiCoin Strategies

Auto-installed on deploy:

• FundingRateStrategy — Exploit extreme funding rates for mean reversion (Basic tier)
• WhaleFollowStrategy — Follow whale order flow + contrarian L/S ratio (Standard tier)
• LiquidationHunterStrategy — Profit from liquidation cascades (Advanced tier)

User Journey

"帮我写一个资金费率策略"
  → node scripts/ft-deploy.mjs create_strategy '{"name":"FundingStrat","timeframe":"15m","aicoin_data":["funding_rate"]}'

"回测一下"
  → node scripts/ft-deploy.mjs backtest '{"strategy":"FundingStrat","timeframe":"15m","timerange":"20250101-20260301"}'

"不错，部署"
  → node scripts/ft-deploy.mjs deploy '{"pairs":["BTC/USDT:USDT"]}'

"上实盘"
  → node scripts/ft-deploy.mjs deploy '{"dry_run":false}'

"今天赚了多少？"
  → node scripts/ft.mjs profit

Cross-Skill References

Common Errors

• errorCode 304 / HTTP 403 — Paid AiCoin feature. Do NOT retry. See Paid Feature Guide below.
• Python not found — Need Python 3.11+. ft-deploy.mjs check validates this.
• Strategy not found — Check ft-deploy.mjs strategy_list. File must be in ~/.freqtrade/user_data/strategies/.
• Timerange format — Use YYYYMMDD-YYYYMMDD (e.g., 20250101-20260301).
• Timeout — Freqtrade ops may take 5+ min. Use ft-deploy.mjs which handles timeouts.

Paid Feature Guide

When a script returns 304 or 403: Do NOT retry. Tell the user:

1. What happened: This AiCoin data feature needs a paid API subscription.
2. How to get a key: Visit https://www.aicoin.com/opendata to register and create an API key.
3. Tier options (for aicoin_data in strategies):

4. How to configure: Add to .env file:

AICOIN_ACCESS_KEY_ID=your-key-id
AICOIN_ACCESS_SECRET=your-secret

5. .env auto-loaded from: cwd → ~/.openclaw/workspace/.env → ~/.openclaw/.env. After configuring, the same script command will work.
6. MUST tell the user: AiCoin API Key 仅用于获取市场数据，无法进行任何交易操作。如需在交易所下单，需要单独到交易所申请交易 API Key。所有密钥仅保存在你的本地设备 .env 文件中，不会上传到任何服务器。

Troubleshooting

1. Check Python: python3 --version (need 3.11+)
2. Check logs: node scripts/ft-deploy.mjs logs
3. Verify exchange keys in .env (see Setup)
4. DO NOT try manual fixes — report error, let ft-deploy.mjs handle it