# 加密市场AI交易技能集

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

<div align="center">

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

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

<br />

[![版本](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)
[![许可证](https://img.shields.io/badge/MIT-License-f59e0b?style=for-the-badge&logo=opensourceinitiative&logoColor=white)](./LICENSE)
[![技能](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 />

</div>

<div align="center">

## CoinOS 是什么？

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

</div>

<div align="center">

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

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

</div>

<div align="center">

<table>
<tr><td>

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

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

<br />

## 技能矩阵

</div>

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

**市场情报**

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

</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 上的巨鲸持仓追踪、爆仓数据、交易员 PnL 分析 |

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

**账户管理**

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

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

<div align="center">
<br />

## AiCoin 独家数据

**别处无法获取的数据 —— 实时聚合自 200+ 家交易所。**

</div>

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

**巨鲸与情绪情报**

| 数据 | 含义 |
|:--|:--|
| **巨鲸订单** | 跨交易所的实时大额买卖订单 |
| **多空比** | 聚合市场持仓 —— 交易员整体是多还是空？ |
| **资金费率** | 跨交易所加权费率 —— 发现过度杠杆市场 |
| **爆仓热力图** | 爆仓集群热力图 —— 找到轧仓区域 |
| **持仓量** | 聚合 OI 趋势 —— 验证或质疑价格走势 |

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

**新闻与 Alpha 发现**

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

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

<div align="center">

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

<br />

## 策略与回测

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

</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、威廉指标 |
| **波动率** | 布林带、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 轮"

# 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 />

## 架构

</div>

```
                         ┌─────────────────────┐
                         │   AI 代理（自然语言）  │
                         └──────────┬───────────┘
                                    │
                         ┌──────────▼───────────┐
                         │    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 />

## 快速开始

</div>

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

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

<div align="center">

然后，直接与 AI 代理对话：

</div>

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

<div align="center">

无需任何配置。内置免费 API 密钥，开箱即用。

<br />

## 支持的交易所

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

<br />

## 使用示例

</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>

```
你:      Show me ETH 1h K-line.

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 顶级巨鲸持仓（Hyperliquid）
         ─────────────────────────────────────
         🐋 0x1a2b...  做多   $12.5M   +$340K PnL
         🐋 0x3c4d...  做空   $8.2M    -$120K PnL
         🐋 0x5e6f...  做多   $6.8M    +$89K  PnL
         ─────────────────────────────────────
         净偏向: 65% 多头
```

</details>

<div align="center">
<br />

## 环境变量

</div>

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

```bash
# AiCoin API（可选 —— 内置免费密钥受 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"
```

<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 雷达与项目分析
│   │
│   ├── 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     巨鲸持仓、PnL、排行榜
│   │
│   └── aicoin-account/       # 账户管理
│       ├── SKILL.md
│       ├── lib/
│       └── scripts/
│           ├── exchange.mjs      余额、持仓、订单
│           ├── api-key-info.mjs  API 密钥管理
│           ├── check-tier.mjs    验证 API 等级/订阅
│           └── register.mjs      交易所注册
│
├── AGENTS.md                 # AI 代理的技能路由
├── CLAUDE.md                 # 开发说明
└── .claude-plugin/
    └── plugin.json           # 插件元数据
```

</details>

<div align="center">

<br />

## 许可证

[MIT License](./LICENSE)

<br />

**Powered by** [AiCoin Open 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>