Aicoin Freqtrade
Use when user asks about Freqtrade — strategy creation, backtest, hyperopt, switching strategies / pairs / dry-run mode, querying live bot status / balance /... Skill: Aicoin Freqtrade Owner: procaross Summary: Use when user asks about Freqtrade — strategy creation, backtest, hyperopt, switching strategies / pairs / dry-run mode, querying live bot status / balance /... Tags: aicoin:1.0.0, bot:1.0.0, crypto:1.0.0, freqtrade:1.0.0, latest:3.5.4 Version history: v3.5.4 | 2026-05-21T07:35:48.973Z | user 同步最新仓库变更:set-key 支持直接喂后台 JSON + install-test 实测修正 (catalog 分组冲突 / 403 信封归一)
Rank
62
Safety
84
Downloads
1.1k
Updated
Oct 11, 2026
Version
3.5.4
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1.1K downloadsadoption · observed Oct 11, 2026
- Latest release
- 3.5.4release · observed May 21, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s175bxjmb4brzmpkpbfqaqpc3d872sdw:aicoin-freqtrade- Node.js workspace detected. Install dependencies securely: run `npm ci --ignore-scripts` to prevent post-install lifecycle triggers from running arbitrary code, then selectively audit the dependency tree.
- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-procaross-aicoin-freqtrade/snapshot"
Documentation
CLAWHUB
151,950 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: aicoin-freqtrade
description: "Use when user asks about Freqtrade — strategy creation, backtest, hyperopt, switching strategies / pairs / dry-run mode, querying live bot status / balance / open positions / 盈亏. Trigger words: 'write strategy', 'create strategy', 'backtest', 'switch strategy', 'switch to live', 'open positions', 'P&L', '写策略', '创建策略', '回测', '部署策略', '切策略', '切实盘', '当前持仓', '今天赚多少', '盈亏'. In CoinClaw containers (OpenClaw / Hermes / Claude Code) freqtrade is a supervisord-managed daemon on :8080 — this skill auto-detects engine + paths via lib/coinclaw-env.mjs and never spawns competing freqtrade processes. Outside CoinClaw it falls back to host mode (clone freqtrade + nohup). For prices/charts use aicoin-market. For exchange trading use aicoin-trading. For Hyperliquid use aicoin-hyperliquid."
metadata: { "openclaw": { "primaryEnv": "AICOIN_ACCESS_KEY_ID", "requires": { "bins": ["node"] }, "homepage": "https://www.aicoin.com/opendata", "source": "https://github.com/aicoincom/coinos-skills", "license": "MIT" } }
---
# AiCoin Freqtrade
Freqtrade 策略 / 回测 / 部署 / 实时控制 — 跨 CoinClaw 三引擎自动适配。
## 关键原则(读完再动手)
### 一、CoinClaw 容器里 freqtrade 是常驻 daemon
OpenClaw / Hermes / Claude Code 三个引擎容器都通过 supervisord 把 freqtrade 起为常驻进程, 监听 `127.0.0.1:8080`, 默认跑 `NoOpStrategy`(空跑). **不要自己起 freqtrade 进程** — 会跟 daemon 抢端口, dashboard 立刻 offline.
正确流程是: 写策略文件 → 调 `ft-deploy.mjs deploy {"strategy":"..."}` → 脚本改 config + 重启 daemon. dashboard 会自动刷出新策略.
`scripts/ft.mjs` + `scripts/ft-deploy.mjs` 内置三引擎自动识别(`lib/coinclaw-env.mjs`), 路径 / auth / supervisord socket 都自动解析, **agent 不用关心是哪个引擎**.
### 二、永远先调 freqtrade REST API, 不要"自己计算"
| 用户问 | 必须先调 |
|---|---|
| 现在赚多少 / 总盈亏 / 今天涨了多少 | `ft.mjs profit` (`/api/v1/profit`) |
| 持仓 / 现在开了哪些 | `ft.mjs trades_open` (`/api/v1/status`) |
| 余额 / 资金多少 | `ft.mjs balance` (`/api/v1/balance`) |
| 跑的什么策略 / 当前模式 | `ft.mjs daemon_info` 或 `config` |
| 历史交易 / 已平仓 | `ft.mjs trades_history` |
| 单交易对绩效 | `ft.mjs profit_per_pair` |
**dashboard 数字对齐规则(关键)**: 用户问"赚了多少"必须报告**两个数字**:
- **已平仓累计盈亏** = `profit_closed_coin` (USDT) — **dashboard 顶栏的累计盈亏 = 这个**
- **含浮动总盈亏** = `profit_all_coin` (USDT) — 已平仓 + 当前持仓的浮动盈亏
只调 `/status` 拿持仓浮动盈亏会漏掉已平仓部分, 导致跟 dashboard 数字不一致 — 用户立刻发现, 信任度归零.
### 三、切策略 / 切实盘 / 切交易对必须走脚本
config.json 是 daemon 启动时读一次, 手动改完不会自动生效. 必须用:
| 操作 | 命令 | 是否需要 daemon 重启 |
|---|---|---|
| 切策略 | `ft.mjs set_strategy {"strategy":"X"}` | 必须重启 (~30s) |
| 切交易对 | `ft.mjs set_pairs {"pairs":[...]}` | 不重启, `reload_config` 即可 |
| 切实盘/模拟 | `ft.mjs set_dry_run {"dry_run":false}` | 必须重启 |
| reload 配置 | `ft.mjs reload` | 不重启 |
或者一次完成所有变更: `ft-deploy.mjs deploy {"strategy":"X","pairs":["BTC/USDT:USDT"],"dry_run":false}`.
**任何直接修改 config.json 的操作(包括手动编辑 pair_whitelist / minimal_roi / stoploss 等), 改完后必须立即调 `ft.mjs reload`** — 否则 daemon 仍用内存里的旧配置运行, 白名单/止损等改动不会生效. 忘了 reload 是最常见的"改了但没用"的原因.
**chat 主动发起的高 stake 操作必须强 confirm**(违反即错):
适用: 用户在 chat 里说"平掉"、"切实盘"、"卖了"、"开仓"等 — 通过 agent 调用 `force_exit` / `force_enter` / `set_dry_run` 的操作.
流程:
1. *_meta.json
{
"ownerId": "kn744cgmrtxwys18mxjhzaapn582553w",
"slug": "aicoin-freqtrade",
"version": "3.5.4",
"publishedAt": 1779348948973
}skill-card.md
## Description: Helps agents create, backtest, tune, deploy, and operate Freqtrade strategies with AiCoin market data integrations across CoinClaw-style agent containers and host-mode environments. This skill is ready for commercial/non-commercial use. ## Publisher: [procaross](https://clawhub.ai/user/procaross) ### License/Terms of Use: MIT-0 ## Use Case: External developers and trading-bot operators use this skill to generate and manage Freqtrade strategies, run backtests and hyperopt, switch strategies or trading pairs, and query live bot status, balances, positions, and profit/loss. It is intended for users who understand the risks of automated cryptocurrency trading and can review generated strategy files before deployment. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: The skill can control a Freqtrade bot and may interact with configured exchange credentials, which can lead to real trading losses if used in live mode. Mitigation: Start in dry-run mode, verify exchange credentials and balances separately, and require explicit confirmation before live-mode or manual open/close actions. Risk: Generated or modified strategy files can affect automated trading behavior. Mitigation: Review strategy code and configuration changes before deployment, then backtest or dry-run before allowing live trading. Risk: Crafted action parameters or host-mode setup paths can run unintended commands or code. Mitigation: Avoid untrusted action inputs, prefer the managed CoinClaw daemon path, and install host prerequisites independently instead of relying on host-mode auto-install. Risk: Pointing AICOIN_BASE_URL at a non-AiCoin host can redirect API traffic and credentials. Mitigation: Keep AICOIN_BASE_URL unset or set only to an AiCoin-controlled endpoint. ## Reference(s): - [AiCoin Open Data](https://www.aicoin.com/opendata) - [AiCoin Open API v3 Catalog](https://open.aicoin.com/api/v3/_catalog) - [ClawHub skill page](https://clawhub.ai/procaross/skills/aicoin-freqtrade) - [Publisher profile](https://clawhub.ai/user/procaross) ## Skill Output: **Output Type(s):** [text, markdown, code, shell commands, configuration, guidance] **Output Format:** [Markdown guidance with inline shell commands, JSON parameters, and generated Python strategy code] **Output Parameters:** [1D] **Other Properties Related to Output:** [May create or modify Freqtrade strategy and configuration files when used by an agent with filesystem and command execution access.] ## Skill Version(s): 3.5.4 (source: ClawHub release evidence; artifact package.json reports 3.5.2) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
lib/defaults.json
{
"comment": "Public free-tier AiCoin API key. IP rate-limited. Users can replace with their own key via env vars.",
"accessKeyId": "ronJ8uI0Yj2soAfGVs5H1YALUIINbE22",
"accessSecret": "CWHZcH2us1CLSE7grroR1TpS0Z1JxTwU"
}package.json
{
"name": "aicoin-freqtrade",
"version": "3.5.2",
"private": true,
"type": "module"
}AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/procaross/skills/aicoin-freqtrade",
"sourceUrl": "https://clawhub.ai/procaross/skills/aicoin-freqtrade",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T12:14:35.491Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-procaross-aicoin-freqtrade/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-procaross-aicoin-freqtrade/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T12:14:35.491Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.1K downloads",
"href": "https://clawhub.ai/procaross/aicoin-freqtrade",
"sourceUrl": "https://clawhub.ai/procaross/aicoin-freqtrade",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T12:14:35.491Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "3.5.4",
"href": "https://clawhub.ai/procaross/aicoin-freqtrade",
"sourceUrl": "https://clawhub.ai/procaross/aicoin-freqtrade",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-21T07:35:48.973Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-procaross-aicoin-freqtrade/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-procaross-aicoin-freqtrade/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 3.5.4",
"description": "同步最新仓库变更:set-key 支持直接喂后台 JSON + install-test 实测修正 (catalog 分组冲突 / 403 信封归一)",
"href": "https://clawhub.ai/procaross/aicoin-freqtrade",
"sourceUrl": "https://clawhub.ai/procaross/aicoin-freqtrade",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-21T07:35:48.973Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.
