# 加密市场AI交易技能集

`加密货币` `量化交易` `AI Agent` `市场数据` `回测`

<div align="center">

<pre>
 ██████╗ ██████╗ ██╗███╗   ██╗ ██████╗ ███████╗
██╔════╝██╔═══██╗██║████╗  ██║██╔═══██╗██╔════╝
██║     ██║   ██║██║██╔██╗ ██║██║   ██║███████╗
██║     ██║   ██║██║██║╚██╗██║██║   ██║╚════██║
╚██████╗╚██████╔╝██║██║ ╚████║╚██████╔╝███████║
 ╚═════╝ ╚═════╝ ╚═╝╚═╝  ╚═══╝ ╚═════╝ ╚══════╝
</pre>

### `> 面向 AI Agent 的加密市场数据、交易与量化自动化_`

<br />

[![Version](https://img.shields.io/badge/v2.0.0-blueviolet?style=for-the-badge&logo=semver&logoColor=white)](https://github.com/aicoincom/coinos-skills/releases)
[![JavaScript](https://img.shields.io/badge/ESM-f7df1e?style=for-the-badge&logo=javascript&logoColor=black)](https://nodejs.org/)
[![AiCoin API](https://img.shields.io/badge/AiCoin_API-00d4aa?style=for-the-badge&logo=bitcoin&logoColor=white)](https://www.aicoin.com/opendata)
[![License](https://img.shields.io/badge/MIT-License-f59e0b?style=for-the-badge&logo=opensourceinitiative&logoColor=white)](./LICENSE)
[![Skills](https://img.shields.io/badge/Skills-5_included-ff6b6b?style=for-the-badge&logo=openai&logoColor=white)](./skills/)

<br />

[English](./README.md) · [简体中文](./README-CN.md)

<br />

<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" alt="-----" />

</div>

<div align="center">

## CoinOS 是什么？

**一句话查询。一句话交易。一句话回测。**

</div>

<div align="center">

CoinOS 是一套封装了 [AiCoin 开放 API](https://www.aicoin.com/opendata) 的 AI 技能集——将实时加密市场数据、交易所交易、Freqtrade 策略自动化以及 Hyperliquid 大户分析能力带给任意 AI Agent。

支持 **Claude Code、Cursor、Codex、OpenClaw、Windsurf、Gemini CLI** 等平台。

</div>

<div align="center">

<table>
<tr><td>

- 无需 API Key —— **内置免费 Key**，开箱即用
- 所有数据来自 **AiCoin**，领先的加密数据分析平台
- **5 个技能**，各自独立，可单独安装

</td></tr>
</table>

<br />
<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" alt="-----" />

## 技能矩阵

</div>

<div align="center">
<table>
<tr>
<td width="50%">

**市场行情**

| 技能 | 能力 |
|:--|:--|
| **aicoin-market** | 价格、K线、资金费率、持仓量、大单、新闻、信号、空投、Drop Radar |

</td>
<td width="50%">

**交易所交易**

| 技能 | 能力 |
|:--|:--|
| **aicoin-trading** | 在 Binance、OKX、Bybit 等 9 家交易所买卖，自动化交易策略 |

</td>
</tr>
<tr>
<td width="50%">

**量化自动化**

| 技能 | 能力 |
|:--|:--|
| **aicoin-freqtrade** | 使用 AiCoin 指标创建策略、回测、超参优化、实盘机器人部署 |

</td>
<td width="50%">

**大户分析**

| 技能 | 能力 |
|:--|:--|
| **aicoin-hyperliquid** | Hyperliquid 大户持仓追踪、爆仓数据、交易员盈亏分析 |

</td>
</tr>
<tr>
<td colspan="2">

**账户管理**

| 技能 | 能力 |
|:--|:--|
| **aicoin-account** | 余额与持仓、历史订单、API Key 管理、附带邀请链接的交易所注册 |

</td>
</tr>
</table>
</div>

<div align="center">
<br />
<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" alt="-----" />

## AiCoin 独家数据

**其他平台没有的数据——实时聚合自 200+ 家交易所。**

</div>

<div align="center">
<table>
<tr>
<td width="50%">

**大户与情绪情报**

| 数据 | 说明 |
|:--|:--|
| **大单监控** | 跨交易所实时大买/大卖订单 |
| **多空比** | 聚合市场持仓方向——当前是净多还是净空？ |
| **资金费率** | 跨交易所加权费率——发现过度杠杆市场 |
| **爆仓热力图** | 爆仓聚集区热力图——寻找轧空区间 |
| **持仓量** | 聚合 OI 趋势——验证或质疑价格走势 |

</td>
<td width="50%">

**新闻与 Alpha 发现**

| 数据 | 说明 |
|:--|:--|
| **快讯** | 主流媒体之前的加密突发新闻 |
| **Twitter/X 信息流** | 实时 KOL 推文、大 V 发现 |
| **Drop Radar** | 空投情报：团队、融资、X 粉丝数、状态 |
| **信号提醒** | 预置异常检测与策略信号 |
| **国库追踪** | 机构持仓（MicroStrategy、基金等） |

</td>
</tr>
</table>
</div>

<div align="center">

> 大多数平台只给你价格。AiCoin 告诉你**大户在做什么、市场情绪如何、接下来会发生什么**——覆盖 200+ 家交易所，一个 API 全搞定。

<br />
<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" alt="-----" />

## 策略与回测

**一句话写策略。用真实数据回测。部署上线。**

</div>

CoinOS 与 [Freqtrade](https://github.com/freqtrade/freqtrade) 深度集成，并将 **AiCoin 独家链上/情绪数据**直接注入策略——这是其他任何回测工具都无法提供的能力。

<div align="center">
<table>
<tr>
<td width="50%">

**17 个内置指标**

| 类别 | 指标 |
|:--|:--|
| **趋势** | EMA、SMA、ADX、一目均衡表 |
| **动量** | RSI、MACD、随机指标/KDJ、CCI、威廉指标 %R |
| **波动率** | 布林带、ATR |
| **成交量** | VWAP、OBV、成交量 SMA |

</td>
<td width="50%">

**5 个 AiCoin 独家数据源**

| 数据 | 策略用途 |
|:--|:--|
| **funding_rate** | 费率 > 0.1% = 多单过多，反向做空 |
| **ls_ratio** | 比率 < 0.45 = 空单拥挤，反向做多 |
| **big_orders** | 大单为正 = 聪明钱在吸筹 |
| **liquidation_map** | 爆仓聚集区 = 轧空机会 |
| **open_interest** | OI 上升 + 价格下跌 = 反转临近 |

</td>
</tr>
</table>
</div>

<div align="center">

**一条命令创建。一条命令回测。一条命令部署。**

</div>

```bash
# 1. 使用 AiCoin 数据 + 技术指标创建策略
> "帮我写一个资金费率策略，加入 RSI 和布林带，15分钟周期"

# 2. 用真实历史 K 线数据回测
> "在 BTC/USDT 上回测，2025 年全年"

# 3. 优化参数
> "运行超参优化，500 个 epoch"

# 4. 部署上线
> "在 Binance 上以模拟盘模式部署机器人"
```

```
回测结果
─────────────────────────────────────────────────
策略:           FundingRateStrat
时间范围:       2025-01-01 → 2025-12-31
交易对:         BTC/USDT
─────────────────────────────────────────────────
总交易次数:     142
胜率:           63.4%
总收益:         +18.7%
最大回撤:       -8.2%
夏普比率:       1.45
─────────────────────────────────────────────────
AiCoin 数据:    funding_rate（仅限实盘/模拟盘）
技术指标:       RSI、布林带
─────────────────────────────────────────────────
```

<div align="center">

> 传统回测只使用价格 + 成交量。CoinOS 策略在实盘交易中还能额外响应**大户行为、市场情绪和爆仓压力**——赋予机器人纯技术分析无法企及的优势。

<br />
<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" alt="-----" />

## 架构

</div>

```
                         ┌─────────────────────┐
                         │   AI Agent（自然语言）│
                         └──────────┬───────────┘
                                    │
                         ┌──────────▼───────────┐
                         │    CoinOS 技能集      │
                         └──────────┬───────────┘
                                    │
          ┌─────────────┬───────────┼───────────┬─────────────┐
          │             │           │           │             │
   ┌──────▼──────┐ ┌────▼────┐ ┌────▼────┐ ┌────▼────┐ ┌─────▼─────┐
   │   market    │ │ trading │ │freqtrade│ │  hyper  │ │  account  │
   │             │ │         │ │         │ │ liquid  │ │           │
   │ coin.mjs    │ │exchange │ │ft-deploy│ │hl-market│ │exchange   │
   │ market.mjs  │ │  .mjs   │ │  .mjs   │ │  .mjs   │ │  .mjs     │
   │ news.mjs    │ │auto-    │ │ ft.mjs  │ │hl-trader│ │register   │
   │ features.mjs│ │trade.mjs│ │ft-dev   │ │  .mjs   │ │  .mjs     │
   │ twitter.mjs │ │         │ │  .mjs   │ │         │ │           │
   │newsflash.mjs│ │         │ │         │ │         │ │           │
   └──────┬──────┘ └────┬────┘ └────┬────┘ └────┬────┘ └─────┬─────┘
          │             │           │           │             │
          └─────────────┴───────┬───┴───────────┘             │
                                │                             │
                     ┌──────────▼───────────┐      ┌──────────▼──────────┐
                     │   AiCoin 开放 API    │      │   交易所 API        │
                     │  （市场数据层）       │      │ Binance/OKX/Bybit.. │
                     └──────────────────────┘      └─────────────────────┘
```

<div align="center">

每个技能均**完全独立**，拥有自己的 `SKILL.md`、`lib/` 和 `scripts/`。所有脚本共享同一个 `aicoin-api.mjs` 客户端库。

<br />
<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" alt="-----" />

## 快速开始

</div>

```bash
# 通过 npx 安装
npx skills add aicoincom/coinos-skills

# 选择要安装的技能，或使用 --yes 一键安装全部 5 个
```

<div align="center">

然后，直接与 AI Agent 对话：

</div>

```
> "BTC 现在多少钱？"
> "给我看一下 ETH 的 1 小时 K 线"
> "帮我写一个资金费率策略"
> "查一下 OKX 余额"
> "Hyperliquid 上 BTC 大户都在做什么方向？"
```

<div align="center">

无需任何配置。内置免费 API Key 开箱即用。

<br />
<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" alt="-----" />

## 支持的交易所

| 交易所 | ID | 现货 | 合约 | 说明 |
|:--|:--|:--:|:--:|:--|
| **Binance** | `binance` | ✅ | ✅ | 全球交易量最大 |
| **OKX** | `okx` | ✅ | ✅ | 高级衍生品平台 |
| **Bybit** | `bybit` | ✅ | ✅ | 领先永续合约交易所 |
| **Bitget** | `bitget` | ✅ | ✅ | 跟单交易龙头 |
| **Gate.io** | `gate` | ✅ | ✅ | 1700+ 交易对 |
| **HTX** | `htx` | ✅ | ✅ | 全球数字资产平台 |
| **KuCoin** | `kucoin` | ✅ | ✅ | 人民的交易所 |
| **MEXC** | `mexc` | ✅ | ✅ | 上币速度最快 |
| **Coinbase** | `coinbase` | ✅ | — | 美国合规交易所 |

<br />
<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" alt="-----" />

## 使用示例

</div>

<details open>
<summary><strong>市场行情</strong></summary>

```
用户:    BTC 现在多少钱？

CoinOS:  BTC/USDT — $84,302.50
         24h 涨跌:   +2.34%
         24h 最高:   $85,100.00
         24h 最低:   $82,450.00
         24h 成交量: $28.5B
```

</details>

<details>
<summary><strong>K 线与技术分析</strong></summary>

```
用户:    给我看一下 ETH 1 小时 K 线。

CoinOS:  从 OKX 获取 100 根 K 线，返回带时间戳的 OHLCV 数据，
         可直接用于图表绘制或分析。
```

```bash
# 直接调用脚本
node skills/aicoin-market/scripts/market.mjs kline \
  '{"symbol":"ethusdt:okex","period":"3600","size":"100"}'
```

</details>

<details>
<summary><strong>交易所交易</strong></summary>

```
用户:    帮我在 Binance 买入 0.1 个 BTC

CoinOS:  订单预览
         ─────────────────────────────────────
         交易所:   Binance
         交易对:   BTC/USDT
         方向:     买入
         类型:     市价单
         数量:     0.1 BTC
         预估费用: ~$8,430.25
         ─────────────────────────────────────
         确认后执行。
```

</details>

<details>
<summary><strong>策略与回测</strong></summary>

```
用户:    帮我写一个资金费率策略，15分钟周期

CoinOS:  正在通过 ft-deploy.mjs 创建策略...
         ✓ 策略 "FundingRateStrat" 已创建
         ✓ 时间周期: 15m
         ✓ AiCoin 数据: funding_rate
         ✓ 文件: user_data/strategies/FundingRateStrat.py

用户:    回测一下，2025年全年

CoinOS:  正在运行回测...
         ─────────────────────────────────────
         策略:      FundingRateStrat
         时间范围:  2025-01-01 → 2025-12-31
         总交易次数: 142
         胜率:       63.4%
         总收益:     +18.7%
         最大回撤:   -8.2%
         夏普比率:   1.45
```

</details>

<details>
<summary><strong>Hyperliquid 大户追踪</strong></summary>

```
用户:    Hyperliquid 上 BTC 大户都在做什么方向？

CoinOS:  BTC 大户持仓 Top（Hyperliquid）
         ─────────────────────────────────────
         🐋 0x1a2b...  做多   $12.5M   +$340K 盈亏
         🐋 0x3c4d...  做空   $8.2M    -$120K 盈亏
         🐋 0x5e6f...  做多   $6.8M    +$89K  盈亏
         ─────────────────────────────────────
         净偏向: 65% 做多
```

</details>

<div align="center">
<br />
<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" alt="-----" />

## 环境变量

</div>

创建 `.env` 文件（脚本自动从当前目录、`~/.openclaw/workspace/.env` 或 `~/.openclaw/.env` 加载）：

```bash
# AiCoin API（可选——内置免费 Key 受 IP 限速限制）
AICOIN_ACCESS_KEY_ID="your-key"
AICOIN_ACCESS_SECRET="your-secret"

# 交易所交易（仅在需要时填写）
BINANCE_API_KEY="xxx"
BINANCE_API_SECRET="xxx"
# 支持: BINANCE, OKX, BYBIT, BITGET, GATE, HTX, KUCOIN, MEXC, COINBASE
# OKX 还需要: OKX_PASSWORD="xxx"

# 代理（可选）
PROXY_URL="socks5://127.0.0.1:7890"
```

<div align="center">
<br />
<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" alt="-----" />
</div>

<details>
<summary><strong>项目结构</strong></summary>

<br />

```
coinos-skills/
├── skills/
│   ├── aicoin-market/        # 价格、K线、新闻、信号
│   │   ├── SKILL.md
│   │   ├── lib/
│   │   └── scripts/
│   │       ├── coin.mjs          价格、行情、币种信息
│   │       ├── market.mjs        K线、资金费率、持仓量
│   │       ├── features.mjs      大户订单、大额成交
│   │       ├── news.mjs          新闻信息流、搜索
│   │       ├── newsflash.mjs     突发新闻提醒
│   │       ├── twitter.mjs       加密 Twitter/X 信息流
│   │       ├── airdrop.mjs       空投查询
│   │       └── drop_radar.mjs    Drop Radar 与项目分析
│   │
│   ├── aicoin-trading/       # 交易所交易
│   │   ├── SKILL.md
│   │   ├── lib/
│   │   └── scripts/
│   │       ├── exchange.mjs      下单、余额、持仓
│   │       └── auto-trade.mjs    自动化交易策略
│   │
│   ├── aicoin-freqtrade/     # 策略自动化
│   │   ├── SKILL.md
│   │   ├── lib/
│   │   └── scripts/
│   │       ├── ft-deploy.mjs     创建、回测、部署机器人
│   │       ├── ft.mjs            Freqtrade CLI 封装
│   │       └── ft-dev.mjs        策略开发辅助工具
│   │
│   ├── aicoin-hyperliquid/   # 大户分析
│   │   ├── SKILL.md
│   │   ├── lib/
│   │   └── scripts/
│   │       ├── hl-market.mjs     行情、订单簿、成交
│   │       └── hl-trader.mjs     大户持仓、盈亏、排行榜
│   │
│   └── aicoin-account/       # 账户管理
│       ├── SKILL.md
│       ├── lib/
│       └── scripts/
│           ├── exchange.mjs      余额、持仓、订单
│           ├── api-key-info.mjs  API Key 管理
│           ├── check-tier.mjs    验证 API 等级/订阅
│           └── register.mjs      交易所注册
│
├── AGENTS.md                 # AI Agent 技能路由
├── CLAUDE.md                 # 开发说明
└── .claude-plugin/
    └── plugin.json           # 插件元数据
```

</details>

<div align="center">

<br />

## 许可证

[MIT License](./LICENSE)

<br />

<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" alt="-----" />

<br />

**技术支持** [AiCoin 开放 API](https://www.aicoin.com/opendata) · [CCXT](https://github.com/ccxt/ccxt) · [Freqtrade](https://github.com/freqtrade/freqtrade)

<br />

```
为原生 AI 加密交易而生。
```

<br />

<sub>由 <a href="https://www.aicoin.com">AiCoin</a> 出品</sub>

</div>