osulivan

CryptoAgent — AI skill for Claude Code

AI community

AI Agent 数字货币交易助手 - 用户使用自然语言编写交易规则，Agent自动执行交易计划.

How to install CryptoAgent

This entry records only its repository, not the path inside it, so there is no exact command to give. Open osulivan/CryptoAgent and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What CryptoAgent does

AI Agent 数字货币交易助手 - 用户使用自然语言编写交易规则，Agent自动执行交易计划.

Alternatives in AI

Agency Agents — A complete AI agency at your fingertips - From frontend wizards to Reddit community ninjas, from whimsy inject 148k ★
Artifacts Builder — Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web tech 97.5k ★
Multica — Make humans and AI agents work as one team — open-source and self-hostable 47.8k ★

README

CryptoAgent - AI 数字货币交易助手

CryptoAgent Dashboard

背景与目的

传统量化的痛点

在没有 AI 模型支持之前，传统量化交易存在以下问题：

一些视觉化且主观性的交易规则难以程序标准化
例如：头肩顶形态、筑底迹象、盘整比较久、布林带收窄走平等形态识别
需要编写大量代码来实现这些规则，且难以快速验证和迭代

我们的解决方案

随着 AI 模型能力的快速迭代，特别是**多模态能力**（视觉理解）的出现，让我们可以：

使用自然语言编写交易规则，无需懂得编程，即可让 Agent 自动看盘并交易
Agent 根据交易规则自行调用工具完成任务
通过修改交易规则，即可快速验证新的交易策略，无需重新编写复杂的量化程序代码

核心特性

🤖 自然语言交易规则 - 用日常语言描述你的交易策略
👁️ K线图表理解 - Agent 能够读取并分析 K 线图表（需要支持视觉的模型）
📊 内置工具集 - 提供行情数据、图表生成、账户管理等工具
⏰ 定时自动执行 - 支持多种时间间隔的自动交易
📱 Web 管理界面 - 直观的可视化管理

⚠️ **当前版本限制**：

目前仅支持永续合约交易
目前仅支持现价开仓和现价平仓操作，挂单、止盈止损等更多交易操作待开发

K线图表技术指标

Agent 在分析 K 线图表时支持以下技术指标（可在交易规则中指定使用以下哪些指标）：

类型	指标
移动平均线	SMA, EMA
趋势指标	ADX, Aroon
动量指标	RSI, MACD, KDJ, Stochastic, CCI, Williams %R
波动率指标	ATR, Bollinger Bands (BBands)
成交量指标	OBV, VWAP, MFI

支持的交易所

交易所	实盘	模拟盘	状态
OKX	✅	✅	已支持
Binance	✅	✅	已支持
Bybit	⏳	⏳	待开发

� 如果这个项目对你有帮助，欢迎在 GitHub 点星支持！星数越多，我们将更有动力开发更多交易所对接。

系统架构

本项目采用前后端分离架构：

API 服务 (端口 8000): Web API，管理任务、账户、模型配置
Agent 服务 (端口 8001): 执行交易任务，定时调度
前端: React + TypeScript，用户界面

快速开始

环境要求

Python 3.13+
Node.js 18+
tmux 或 screen（用于后台运行服务）

安装步骤

# 1. 克隆项目
git clone https://github.com/osulivan/CryptoAgent.git
cd CryptoAgent

# 2. 一键安装
./install.sh

配置

复制环境变量文件（可选，用于代理等）：

cp .env.example .env

在 Web 界面中配置：

交易账户 API 密钥：进入「账户设置」页面添加
AI 模型 API 密钥：进入「模型设置」页面添加

启动服务

./start.sh

服务启动后访问 **http://localhost:5173**

使用指南

1. 配置 AI 模型

Architecture

⚠️ **重要**: 必须使用具有**图片理解能力**的模型（如 GPT-4V、Claude Vision、Kimi-K2.5 、Doubao-Seed-2.0-pro、Qwen-3.5-Plus 等），因为 Agent 需要读取 K 线图表。

进入「模型设置」页：

点击「添加模型」
输入模型名称、Base UR