██████╗ ██████╗ ██╗███╗ ██╗ ██████╗ ███████╗ ██╔════╝██╔═══██╗██║████╗ ██║██╔═══██╗██╔════╝ ██║ ██║ ██║██║██╔██╗ ██║██║ ██║███████╗ ██║ ██║ ██║██║██║╚██╗██║██║ ██║╚════██║ ╚██████╗╚██████╔╝██║██║ ╚████║╚██████╔╝███████║ ╚═════╝ ╚═════╝ ╚═╝╚═╝ ╚═══╝ ╚═════╝ ╚══════╝
CoinOS 是一套 AI Skill 集合,封装 AiCoin Open API 与 OKX Web3 DEX API — 为 AI Agent 提供实时加密货币行情、交易所交易、Freqtrade 量化策略、Hyperliquid 鲸鱼分析、链上 DEX 交易能力。
支持 Claude Code、Cursor、Codex、OpenClaw、Hermes、WorkBuddy、Windsurf、Gemini CLI 等 AI Agent。
|
行情数据
|
交易所交易
|
||||||||
|
量化自动化
|
鲸鱼分析
|
||||||||
|
账户管理
|
链上 DEX
|
|
鲸鱼与情绪数据
|
新闻与 Alpha 发现
|
CoinOS 集成 Freqtrade,并将 AiCoin 独家链上/情绪数据直接注入你的策略 — 这是其他回测工具做不到的。
|
17 个内置技术指标
|
5 种 AiCoin 独家数据
|
一条命令创建。一条命令回测。一条命令部署。
# 1. 用 AiCoin 数据 + 技术指标创建策略
> "帮我写一个资金费率策略,加上 RSI 和布林带,15分钟周期"
# 2. 用真实历史 K 线回测
> "回测一下 BTC/USDT,2025 全年"
# 3. 超参数优化
> "跑一下 hyperopt,500 轮"
# 4. 部署到实盘
> "部署到 Binance,先跑模拟盘"回测结果
─────────────────────────────────────────────────
策略: FundingRateStrat
时间范围: 2025-01-01 → 2025-12-31
交易对: BTC/USDT
─────────────────────────────────────────────────
总交易数: 142
胜率: 63.4%
总收益: +18.7%
最大回撤: -8.2%
夏普比率: 1.45
─────────────────────────────────────────────────
AiCoin 数据: funding_rate(实盘/模拟盘可用)
技术指标: RSI, Bollinger Bands
─────────────────────────────────────────────────
┌──────────────────────┐
│ AI Agent (自然语言) │
└───────────┬──────────┘
│
┌───────────▼──────────┐
│ CoinOS Skills │
└───────────┬──────────┘
│
┌──────────┬──────────┬─────────────┼──────────┬──────────┐
┌──▼───┐ ┌────▼───┐ ┌────▼────┐ ┌──────▼──┐ ┌─────▼───┐ ┌────▼────┐
│market│ │trading │ │freqtrade│ │ hyper │ │ account │ │ onchain │
│行情 │ │ 交易 │ │ 量化 │ │ liquid │ │ 账户 │ │ 链上DEX │
│aicoin│ │exchange│ │ft-deploy│ │ aicoin │ │exchange │ │ swap │
│ .mjs │ │ .mjs │ │ .mjs │ │ .mjs │ │ .mjs │ │ .mjs │
└──┬───┘ └───┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘
│ │ │ │ │ │
└─────────┴─────┬─────┴───────────┘ │ │
│ │ │
┌──────────▼──────────┐ ┌───────────▼─────┐ ┌───▼──────────┐
│ AiCoin Open API │ │ 交易所 API │ │ OKX Web3 API │
│ (行情数据层) │ │ Binance/OKX/… │ │ (链上 DEX) │
└─────────────────────┘ └─────────────────┘ └──────────────┘
每个 Skill 完全独立,拥有自己的 SKILL.md、lib/ 和 scripts/。aicoin-market 和 aicoin-hyperliquid 各自共用一个 catalog 驱动的 v3 客户端(scripts/aicoin.mjs + lib/client.mjs),一个工具能调 AiCoin Open API v3 全部 183 个接口;aicoin-onchain 用独立的 OKX Web3 DEX 客户端(lib/okx-api.mjs)。
# 通过 npx 安装
npx skills add aicoincom/coinos-skills
# 选择要安装的 skill,或用 --yes 全部安装(共 6 个)然后,直接和你的 AI 对话:
> "BTC 现在多少钱?"
> "给我看一下 ETH 的 1 小时 K 线"
> "帮我写一个资金费率策略"
> "查一下 OKX 余额"
> "Hyperliquid 上 BTC 大户都在做什么方向?"
> "在链上把 0.1 ETH 换成 USDC"
行情查询无需任何配置,内置免费 API Key 开箱即用;交易/链上操作再按需配置对应的交易所或 OKX Web3 Key。
| 交易所 | ID | 现货 | 合约 | |
|---|---|---|---|---|
| Binance | binance |
✅ | ✅ | 全球最大交易量 |
| OKX | okx |
✅ | ✅ | 高级衍生品平台 |
| Bybit | bybit |
✅ | ✅ | 永续合约领先 |
| Bitget | bitget |
✅ | ✅ | 跟单交易领先 |
| Gate.io | gate |
✅ | ✅ | 1700+ 交易对 |
| HTX | htx |
✅ | ✅ | 全球数字资产平台 |
| Pionex | pionex |
✅ | ✅ | 网格/量化机器人交易所 |
| Hyperliquid | hyperliquid |
— | ✅ | 链上永续合约 DEX(USDC 结算) |
行情查询
You: BTC 现在多少钱?
CoinOS: BTC/USDT — $84,302.50
24h 涨跌: +2.34%
24h 最高: $85,100.00
24h 最低: $82,450.00
24h 成交量: $28.5B
K线与技术分析
You: 给我看一下 ETH 的 1 小时 K 线
CoinOS: 从 OKX 获取 100 根 K 线,返回 OHLCV 数据
包含时间戳,可用于图表绘制或分析。
# 直接调用脚本
node skills/aicoin-market/scripts/aicoin.mjs market/klines \
'{"coin_key":"ethereum","market":"okx","interval":"1h","limit":100}'交易所交易
You: 帮我在 Binance 买入 0.1 个 BTC
CoinOS: 订单预览
─────────────────────────────────────
交易所: Binance
交易对: BTC/USDT
方向: 买入
类型: 市价
数量: 0.1 BTC
预估花费: ~$8,430.25
─────────────────────────────────────
确认后执行。
链上 DEX 兑换
You: 在链上把 0.1 ETH 换成 USDC
CoinOS: Swap 报价(Ethereum)
─────────────────────────────────────
卖出: 0.1 ETH
买入: ~316.4 USDC
路由: Uniswap V3
预估 gas: ~$2.10
─────────────────────────────────────
确认后广播交易。
策略与回测
You: 帮我写一个资金费率策略,15分钟周期
CoinOS: 通过 ft-deploy.mjs 创建策略...
✓ 策略 "FundingRateStrat" 已创建
✓ 周期: 15m
✓ AiCoin 数据: funding_rate
✓ 文件: user_data/strategies/FundingRateStrat.py
You: 回测一下,2025年全年
CoinOS: 正在运行回测...
─────────────────────────────────────
策略: FundingRateStrat
时间范围: 2025-01-01 → 2025-12-31
总交易数: 142
胜率: 63.4%
总收益: +18.7%
最大回撤: -8.2%
夏普比率: 1.45
Hyperliquid 鲸鱼追踪
You: Hyperliquid 上 BTC 大户都在做什么方向?
CoinOS: BTC 鲸鱼持仓 Top (Hyperliquid)
─────────────────────────────────────
🐋 0x1a2b... 做多 $12.5M +$340K 盈亏
🐋 0x3c4d... 做空 $8.2M -$120K 盈亏
🐋 0x5e6f... 做多 $6.8M +$89K 盈亏
─────────────────────────────────────
整体偏向: 65% 做多
把 key 放进 ~/.coinos/.env(推荐 —— 不管从哪个目录跑脚本都能读到)。脚本自动加载,依次查找:容器 /workspace/.env → ~/.coinos/.env(规范位置)→ 当前目录 .env → 旧 ~/.openclaw/workspace/.env、~/.openclaw/.env(向后兼容)。也可以直接在 shell 里 export(环境变量优先级最高):
# AiCoin API(可选 — 内置免费 Key,有 IP 频率限制)
AICOIN_ACCESS_KEY_ID="your-key"
AICOIN_ACCESS_SECRET="your-secret"
# 交易所交易(aicoin-trading / aicoin-account,按需配置)
BINANCE_API_KEY="xxx"
BINANCE_API_SECRET="xxx"
# 支持: BINANCE, OKX, BYBIT, BITGET, GATE, HTX, PIONEX, HYPERLIQUID
# OKX / Bitget 还需要 passphrase: OKX_PASSWORD="xxx"
# 链上 DEX swap / 钱包(aicoin-onchain,OKX Web3 DEX API)
# 注意:这是与上面 CEX 交易完全不同的另一套 Key
OKX_WEB3_API_KEY="xxx"
OKX_WEB3_SECRET_KEY="xxx"
OKX_WEB3_PASSPHRASE="xxx"
# 代理(可选 — 本地网络无法直连交易所/OKX 时用,支持 socks5h)
PROXY_URL="socks5://127.0.0.1:7890"项目结构
coinos-skills/
├── skills/
│ ├── aicoin-market/ # 行情、K线、新闻、信号、空投
│ │ ├── SKILL.md
│ │ ├── lib/
│ │ └── scripts/
│ │ └── aicoin.mjs 一个 CLI → 全部 183 个 AiCoin v3 接口(catalog 驱动)
│ │
│ ├── aicoin-trading/ # 交易所交易
│ │ ├── SKILL.md
│ │ ├── lib/
│ │ └── scripts/
│ │ ├── exchange.mjs 下单、余额、仓位
│ │ ├── trade.mjs 下单流程封装
│ │ ├── auto-trade.mjs 自动交易策略
│ │ └── register.mjs 交易所注册
│ │
│ ├── aicoin-freqtrade/ # 量化策略
│ │ ├── SKILL.md
│ │ ├── lib/ coinclaw-env / freqtrade-api / strategy-builder / aicoin_data.py
│ │ └── scripts/
│ │ ├── ft-deploy.mjs 创建、回测、部署机器人
│ │ ├── ft.mjs Freqtrade daemon 控制
│ │ └── ft-dev.mjs 策略开发/调试辅助
│ │
│ ├── aicoin-hyperliquid/ # 鲸鱼分析
│ │ ├── SKILL.md
│ │ ├── lib/
│ │ └── scripts/
│ │ └── aicoin.mjs 一个 CLI → 全部 Hyperliquid v3 接口
│ │
│ ├── aicoin-account/ # 账户管理
│ │ ├── SKILL.md
│ │ ├── lib/
│ │ └── scripts/
│ │ ├── exchange.mjs 余额、仓位、订单
│ │ ├── api-key-info.mjs API Key 管理
│ │ ├── check-tier.mjs API 套餐查询
│ │ └── register.mjs 交易所注册
│ │
│ └── aicoin-onchain/ # 链上 DEX 交易
│ ├── SKILL.md
│ ├── lib/
│ │ └── okx-api.mjs OKX Web3 DEX 客户端
│ └── scripts/
│ ├── swap.mjs 报价与兑换执行
│ ├── portfolio.mjs 钱包余额/持仓
│ ├── market.mjs 链上行情
│ ├── token.mjs 代币搜索/信息
│ ├── trade.mjs 交易广播
│ └── gateway.mjs 链路/网关
│
├── AGENTS.md # AI Agent 路由指引
├── CLAUDE.md # 开发说明
└── .claude-plugin/
└── plugin.json # 插件元数据