aicoin-freqtrade

Original：🇺🇸 English
Translated
9 scripts

This skill should be used when the user asks about writing trading strategies, backtesting, deploying Freqtrade bots, quantitative trading, strategy optimization, or any Freqtrade-related operation. Use when user says: 'write strategy', 'create strategy', 'backtest', 'deploy Freqtrade', 'deploy bot', 'quantitative trading', 'strategy optimization', 'hyperopt', 'live trading bot', '写策略', '创建策略', '回测', '部署Freqtrade', '部署机器人', '量化交易', '量化策略', '策略优化', '超参数优化', '实盘机器人'. IMPORTANT: ALWAYS use create_strategy to generate strategy files. NEVER write Python strategy code by hand. For crypto prices/charts, use aicoin-market. For exchange trading, use aicoin-trading. For Hyperliquid, use aicoin-hyperliquid.

13installs
Sourceaicoincom/coinos-skills
Added on

NPX Install

npx skill4agent add aicoincom/coinos-skills aicoin-freqtrade

Tags

Translated version includes tags in frontmatter
freqtradequantitative-tradingtrading-botbacktestingcrypto-trading

SKILL.md Content

View Translation Comparison →

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.
bash
# 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):
Data sourceWhat it doesAiCoin tier
funding_rate
Extreme funding = over-leveraged, trade againstBasic ($29/mo)
ls_ratio
Contrarian signal from retail long/short ratioBasic ($29/mo)
big_orders
Whale buy/sell pressure from institutional ordersStandard ($79/mo)
open_interest
Detect OI spikes = fragile marketProfessional ($699/mo)
liquidation_map
Liquidation cascade direction biasAdvanced ($299/mo)

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:
bash
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

TaskCommand
Create strategy
node scripts/ft-deploy.mjs create_strategy '{"name":"MyStrat","timeframe":"15m","aicoin_data":["funding_rate"]}'
Backtest
node scripts/ft-deploy.mjs backtest '{"strategy":"MyStrat","timeframe":"1h","timerange":"20250101-20260301"}'
Deploy (dry-run)
node scripts/ft-deploy.mjs deploy '{"pairs":["BTC/USDT:USDT"]}'
Deploy (live)
node scripts/ft-deploy.mjs deploy '{"dry_run":false,"pairs":["BTC/USDT:USDT"]}'
Hyperopt
node scripts/ft-deploy.mjs hyperopt '{"strategy":"MyStrat","timeframe":"1h","timerange":"20250101-20260301","epochs":100}'
Strategy list
node scripts/ft-deploy.mjs strategy_list
Bot status
node scripts/ft-deploy.mjs status
Bot logs
node scripts/ft-deploy.mjs logs '{"lines":50}'
Check profit
node scripts/ft.mjs profit
Open trades
node scripts/ft.mjs trades_open

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:
bash
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

ActionDescriptionParams
check
Check prerequisitesNone
deploy
Deploy Freqtrade
{"dry_run":true,"pairs":["BTC/USDT:USDT"]}
backtest
Run backtest
{"strategy":"SampleStrategy","timeframe":"1h","timerange":"20250101-20260301"}
hyperopt
Parameter optimization
{"strategy":"MyStrat","timeframe":"1h","timerange":"20250101-20260301","epochs":100}
create_strategy
Generate strategy file
{"name":"MyStrat","timeframe":"15m","aicoin_data":["funding_rate","ls_ratio"]}
strategy_list
List strategiesNone
update
Update FreqtradeNone
status
Process statusNone
start
Start processNone
stop
Stop processNone
logs
View logs
{"lines":50}
remove
Remove processNone

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

ActionDescriptionParams
ping
Health checkNone
start
Start tradingNone
stop
Stop tradingNone
reload
Reload configNone
config
View configNone
version
Version infoNone
sysinfo
System infoNone
health
Health statusNone
logs
View logs
{"limit":50}
balance
Account balanceNone
trades_open
Open tradesNone
trades_count
Trade countNone
trade_by_id
Trade by ID
{"trade_id":1}
trades_history
Trade history
{"limit":50}
force_enter
Manual entry
{"pair":"BTC/USDT","side":"long"}
force_exit
Manual exit
{"tradeid":"1"}
cancel_order
Cancel order
{"trade_id":1}
delete_trade
Delete record
{"trade_id":1}
profit
Profit summaryNone
profit_per_pair
Profit per pairNone
daily
Daily report
{"count":7}
weekly
Weekly report
{"count":4}
monthly
Monthly report
{"count":3}
stats
StatisticsNone

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

ActionDescriptionParams
backtest_start
Start backtest
{"strategy":"MyStrat","timerange":"20240101-20240601","timeframe":"5m"}
backtest_status
Backtest statusNone
backtest_abort
Abort backtestNone
backtest_history
Backtest historyNone
backtest_result
History result
{"id":"xxx"}
candles_live
Live candles
{"pair":"BTC/USDT","timeframe":"1h"}
candles_analyzed
Candles with indicators
{"pair":"BTC/USDT","timeframe":"1h","strategy":"MyStrat"}
candles_available
Available pairsNone
whitelist
WhitelistNone
blacklist
BlacklistNone
blacklist_add
Add to blacklist
{"add":["DOGE/USDT"]}
locks
Trade locksNone
strategy_list
Strategy listNone
strategy_get
Strategy detail
{"name":"MyStrat"}

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

NeedUse
Prices, K-lines, market dataaicoin-market
Exchange trading (buy/sell)aicoin-trading
Hyperliquid whale trackingaicoin-hyperliquid

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):
TierPriceStrategy Data
Free$0Pure technical indicators only (no 
aicoin_data
)
Basic$29/mo+ 
funding_rate
, 
ls_ratio
Standard$79/mo+ 
big_orders
Advanced$299/mo+ 
liquidation_map
Professional$699/mo+ 
open_interest
  1. How to configure: Add to 
    .env
    file:
AICOIN_ACCESS_KEY_ID=your-key-id
AICOIN_ACCESS_SECRET=your-secret
  1. .env
    auto-loaded from: cwd → 
    ~/.openclaw/workspace/.env
    → 
    ~/.openclaw/.env
    . After configuring, the same script command will work.
  2. 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