astra-quant-agent README

The project's README from github.com/0xethanq/astra-quant-agent. As one markdown file: README.md.

R20 量子交易系统 (R20 Quantum Trading System)

  ____ ____   ___    ___                  _                    _____             _ _             
 |  _ \___ \ / _ \  / _ \ _   _  __ _ _ __| |_ _   _ _ __ ___  |_   _| __ __ _  __| (_)_ __   __ _ 
 | |_) |__) | | | || | | | | | |/ _` | '__| __| | | | '_ ` _ \   | || '__/ _` |/ _` | | '_ \ / _` |
 |  _ </ __/| |_| || |_| | |_| | (_| | |  | |_| |_| | | | | | |  | || | | (_| | (_| | | | | | (_| |
 |_| \_\_____|\___/  \__\_\\__,_|\__,_|_|   \__|\__,_|_| |_| |_|  |_||_|  \__,_|\__,_|_|_| |_|\__, |
                                                                                               |___/ 

Release LINUX DO License Python FastAPI Vue 3 Chart Tests

新一代机构级加密货币波段量化决策与执行系统 · AI 投委会大模型驱动
🔥 核心亮点:全栈策略全要素 100% 深度可自定义 · 17 项执行层硬风控后台可视化 · 三套优质风控预设一键应用 · 0.5s 策略快照原子回滚
插槽化自由编排 · 白盒自进化认知复盘 · Fail-Closed 物理硬拦截 · 多模型决策委员会 · 原生云端 OCO 风控

📸 系统全景一览 · 🎯 策略全要素 100% 自定义 · 1. 提示词策略工作室 · 2. 自进化认知中枢 · 3. 物理拦截插件 · 4. 多模型投委会 · 5. 模型网关配置 · 6. 策略大一统版本快照 · 7. 风控管理中心 · ☕ 赞赏支持 · 🐧 LINUX DO 社区 · 🚀 极速部署 · 发行版日志


💬 官方交流 QQ 群:655973677 | 🐧 开源社区:LINUX DO (linux.do) | 欢迎量化交易员、提示词工程师、大模型 Agent 开发者共同交流探讨实战心得!

微信赞赏码 · 梁文绷
☕ 支持作者 · 微信扫码赞赏 (梁文绷)

🔒 数据流向与隐私 (Data Flow & Privacy)

本系统不内置任何默认第三方中继网关。 所有 LLM 出口必须由使用者显式配置:

配置项 说明
LLM_BASE_URL / OPENAI_BASE_URL 决策提示词的发送目标(OpenAI 兼容端点、官方直连或自建中继均可)
LLM_API_KEY 对应密钥,支持后台加密存储
R20_OKX_ENV=demo 默认模拟盘,实盘需显式切换

📸 系统全景一览

R20 量子交易系统由前台双翼量化操盘终端与后台机构级控制面共同构成:

1. 前台双翼量化操盘大屏(Bento 资产舱 + KLineChart v10 原生 K 线工作站 + 资金费/手续费明细全透传)

前台操盘大屏

2. 后台机构级量化控制面(核心策略、数据健康与物理风控全景监控)

后台机构级控制面

3. 执行层风控管理中心(17 项硬风控可视化 + 三套优质预设一键应用 · v7.6.0)

执行层风控管理中心


🎯 核心设计哲学:策略全要素 100% 深度可自定义 (Full-Stack Customizability)

“策略制定权属于交易员,而非写死的系统硬代码。”

传统量化软件往往将交易标的、仓位杠杆、止盈止损与研判逻辑死死硬编码在底层脚本中,调整极为繁琐且缺乏回溯能力。
R20 量子交易系统彻底摒弃黑盒硬编码,系统中的输入特征、标的池、提示词语义插槽、多模型投委会、物理风控门禁、利润棘轮与版本快照全部解耦为插槽化组件,100% 允许交易员自由定制与热插拔:

                             ┌───────────────────────────────────────────────────────────┐
                             │       R20 全要素 100% 深度可自定义策略架构 (Modular & Pluggable)    │
                             └─────────────────────────────┬─────────────────────────────┘
                                                           │
     ┌───────────────────────┬─────────────────────────────┼─────────────────────────────┬───────────────────────┐
     ▼                       ▼                             ▼                             ▼                       ▼
┌──────────────────┐  ┌──────────────────┐        ┌──────────────────┐          ┌──────────────────┐  ┌──────────────────┐
│ 1. 标的池全要素   │  │ 2. 提示词与插槽  │        │ 3. 执行层风控中心 │          │ 4. 投委会席位矩阵 │  │ 5. 策略大一统快照 │
│    100% 自定义   │  │    100% 自定义   │        │    100% 自定义   │          │    100% 自定义   │  │ 0.5s 秒级回滚    │
├──────────────────┤  ├──────────────────┤        ├──────────────────┤          ├──────────────────┤  ├──────────────────┤
│• 任意OKX合约增删 │  │• System/User 重写│        │• 17项硬风控管理页│          │• 参谋席位自由增删│  │• 4大策略单元打包 │
│• 面值/精度/最小量│  │• 积木式消息管线  │        │• 三套预设一键应用│          │• 席位模型/温度解耦│ │• 唯一 SHA-256 溯源│
│• 基础仓位/风险额 │  │• 语义数据变量插槽│        │• Python插件+沙箱测│          │• 辩论/仲裁流程可调│ │• 0.5s 原子级热回滚│
│• 杠杆上限/ATR倍数│  │• JSON 方案导入导出│       │• 单一事实源全联动│          │• 思考链超时自由配│  │• 台账 100% 溯源绑定│
└──────────────────┘  └──────────────────┘        └──────────────────┘          └──────────────────┘  └──────────────────┘

🛠️ 7 大维度全流程深度自定义一览表

维度 自定义支持范围 配置与生效方式 业务收益
1. 标的池与合约规格 任意 OKX 永续合约/币种扩展、面值 (ctVal)、报价精度 (tickSz)、最小张数 (minSz)、基础仓位 (base_sz)、单笔风险暴露 (risk_per_trade_usd) 前后台动态更新 / 编辑 data/instrument_pool.json 告别固定 6 币种限制,自由交易任意心仪山寨币或主流币
2. 标的分级与风控参数 标的分级(Tier-1 蓝筹 / Tier-2 高弹性动量币)、杠杆上限(2x~5x 自由配置)、宽止损 ATR 乘数、24H 最低流动性门槛 标的池分级管理配置,热生效 蓝筹大资金防滑点,小币种宽止损防插针,差异化风控
3. 提示词策略工作室 「交易 System」军规与「交易 User」模版完全可改,自由启停稳健/激进/自定义方案,积木式卡片拖拽 前台 Prompt Studio 可视化拖拽编排,支持 JSON 导入/导出 任意注入专属于交易员自己的交易哲学与研判流派
4. 语义变量插槽联动 内置 {{macro_4h}}、{{calculus_1h}}、{{smart_money}}、{{account_positions}}、{{trading_memory}} 数据插槽 一键点击或键入插槽变量,毫秒级绑定底层实时特征 自由组合输入特征,大模型上下文仅传输精炼高信息密度数据
5. 物理风控拦截插件 4H 顺势铁律、75%~85% 动态置信度门禁、1H ADX 趋势杂波过滤、2.0R 真实盈亏比门禁、自定义 Python 拦截插件 独立 Python 插件文件,支持前台在线沙箱单步模拟单测 策略规则完全透明可见,杜绝模型幻觉,底座代码物理兜底
6. 多模型投委会与模型矩阵 参谋席位自由增删(进攻官/风控官/数理官/宏观官/舆情官/自定义专家)、席位独立绑定不同大模型与温度、10~1800s 思考超时预算 前台 Council Pro 席位编辑与模型网关直连,支持双轮辩论与单模型极速直出 彻底终结单模型认知偏见,长思考链大模型与极速模型混部调度
7. 执行层风控管理中心 最高持仓数、同向敞口、单笔保证金占比、单标的保证金封顶、杠杆上限、1R 风险额、R:R 硬底线、开仓/加仓置信度门禁、日亏熔断、最长持仓时间、止损冷静期、金字塔加仓门禁等 17 项 后台风控管理页集中配置或三套优质预设一键应用,.env 持久化,下一巡检周期热生效 告别写死在 py 里的黑盒阈值,风控口径提示词/执行层/管理页三位一体

🏛️ 系统核心策略系统能力详析

1. 🎨 提示词策略工作室 (Prompt Studio)

告别硬编码!提示词策略工作室支持交易员在前台可视化编排 「交易 System」 纪律与 「交易 User」 行情组装模版,将市场快讯、自进化心法、微积分动力学矩阵等动态数据抽象为标准语义变量插槽:

提示词策略工作室


2. 🧬 启发式自进化认知中枢 (Self-Evolution)

绝不在回撤期情绪化乱改参数!系统每 6 小时自动读取全量实盘平仓台账进行闭环自省与归因,将真实交易教训沉淀为白盒启发式心法,并由防污染护栏严格捍卫:

自进化认知实验室


3. 🛡️ Fail-Closed Python 物理硬拦截管线 (Interceptors)

“认知决策归模型,物理风控归底座”。系统绝不把止损与风控寄托于 LLM 提示词本身的自律,而是在交易执行底层构筑了不可跳过的 Python 物理插件流水线:

物理拦截插件管线


4. 👥 对冲基金多模型决策委员会 (Council Pro)

引入现代顶级对冲基金 Trading Desk 运作机制,彻底终结单一大模型决策的幻觉与认知盲区:

对冲基金多模型决策委员会


5. 🤖 大模型网关与全局推理配置中心 (LLM Hub)

全开放模型供应商直连矩阵与思考链预算管理,为推理型大模型与轻量极速模型提供工业级调度中枢:

模型网关与全局推理配置


6. 📦 策略大一统版本快照归档与 0.5s 原子回滚 (Policy Snapshot)

针对多组件联动修改可能引发的“策略撕裂”与“回测无法复现”难题,R20 打造了工业级策略快照引擎:

策略大一统版本快照


7. 🎛️ 执行层风控管理中心与优质预设套件 (Risk Control Center)

v7.6.0 起,全部执行层硬风控参数从 py 源码中彻底剥离,收敛至后台「风控管理页」集中可视化配置:

执行层风控管理中心

astra-quant-agent (0xethanq/astra-quant-agent)

crypto-trading
Searching Database…

What is this?R20 Quantum Trading System is an autonomous crypto trading agent that uses a committee of multiple LLMs (Claude, GPT-4o, DeepSeek, Gemini, etc.) to analyze the market and propose trades, while a separate deterministic Python layer enforces hard risk rules and executes orders on OKX.
Is the AI actually placing trades, or just suggesting them?The LLM committee only has 'proposal rights' - every order still has to pass a Python-based Fail-Closed physical interceptor layer before it can be placed, checking geometric validity, R:R >= 2.0, the 4H trend veto, and same-direction position caps.
How do I get it running?Instead of a default provider, you configure LLM_BASE_URL/OPENAI_BASE_URL and LLM_API_KEY yourself for whichever model provider you want to use, then start the system against OKX in simulated mode first.
Do I need my own LLM API key and an OKX account?Yes - the system ships with no built-in default relay gateway, so you must explicitly configure your own LLM endpoint/key (OpenAI-compatible, direct provider, or self-hosted relay) and your own OKX account for execution.
Is it safe to switch straight to live trading?No - it defaults to OKX demo/simulated mode and you must explicitly switch it to live, and even then the 17 execution-layer risk gates (confidence threshold, ADX filter, R:R floor, daily-loss circuit breaker, etc.) can force trades into a WAIT state.
What does the self-evolution feature actually do?Every 6 hours the system reviews real closed trades and distills win-rate and profit-factor lessons into an AI_TRADING_MEMORY.md file that feeds back into every future decision, with guardrails against outlier noise and a 7-14 day half-life so stale lessons get phased out.
What is the multi-model investment committee (Council Pro)?You can freely add or remove advisor seats (momentum, risk, quant, macro, sentiment, or custom experts), bind each seat to a different LLM provider and temperature, and let them debate across rounds before a CIO model issues the final structured order.
Can I roll back if a strategy change goes wrong?Each full configuration (prompts, interceptor plugins, committee seats, and risk parameters) is fingerprinted with SHA-256 and archived as a named snapshot, so you can atomically roll back to any past version in about 0.5 seconds.
Which exchange and instruments does it trade?It trades OKX perpetual futures/contracts through a configurable instrument pool (data/instrument_pool.json), so you aren't limited to a fixed set of coins.
Creator
0xethanq
Size
50.7 MB
Stars
379
Age
1mo
Commits · 90 Days