SystemSelf reportedCryptoTypeScriptasterbnbcryptocurrencydexperptuals

ritmex-bot

Perp DEX trading bot.

System Structure

Data Used
BinanceOHLCV/호가/체결 데이터
Rules / Strategy

저장소별 전략/실행 조건 확인 필요

Execution

거래소 API 기반 자동 주문 실행

Editor Summary

저장소 설명과 공개 메타데이터 기준으로 암호화폐 거래 봇, 거래소 API/프레임워크, 그리드/DCA, 마켓메이킹 성격의 프로젝트로 파악했습니다. 확인 근거는 README, 저장소 토픽, 저장소 설명, GitHub 지표, 파이프라인 필드이며, 주요 데이터는 Binance, OHLCV/호가/체결 데이터입니다. 전략/실행 조건은 저장소별 문서와 코드 확인이 필요하며, 실행 방식은 "거래소 API 기반 자동 주문 실행"라고 보수적으로 기록했습니다. GitHub 지표는 별 449개, 포크 179개입니다.

Repositorydiscountry/ritmex-bot
Creatordiscountry
Stars / Forks★ 449 / 179
Last Updated2026-04-06
Snapshot Date2026-07-08 (README below is a copy from this date)

This is third-party open-source code. QuantField does not guarantee its behavior or safety. Review the code before installing or running it.

View on GitHub →

README

ritmex-bot

For English users, please see README_en.md.

Please set LANG=en in .env for English interface.

A Bun-powered multi-exchange perpetuals workstation that ships an SMA30 trend engine, a Guardian stop sentinel, and two market-making modes. It offers instant restarts, realtime market data, structured logging, and an Ink-based CLI dashboard.

基于 Bun 的多交易所永续合约量化终端，内置趋势跟随（SMA30）、Guardian 防守与做市策略，支持快速恢复、实时行情订阅、日志追踪与 CLI 仪表盘。

如果您希望获取优惠并支持本项目，请考虑使用以下注册链接：

CLI 命令模式（ritmex-bot）

ritmex-bot 支持 Agent 友好的结构化命令调用，覆盖交易所能力查询、行情、账户、仓位、下单、撤单与策略启动。

  • 保持现有环境变量体系，不新增也不改名，只读取当前执行环境中的变量。
  • --symbol 原样透传，不对交易对做统一改写。
  • 支持 --dry-run 模拟执行与 --json 结构化输出，便于自动化系统集成。

安装当前项目 Skill（skills add）

npx skills add https://github.com/discountry/ritmex-bot --skill use-ritmex-bot

如需指定分支，可追加 --ref <branch-or-tag>。

完整文档请见：ritmex-bot CLI 使用手册（中文）

文档索引

核心特性

  • 实时行情与风控：Websocket + REST 自动同步账户、挂单与仓位，断线后自动恢复。
  • 趋势策略：SMA30 穿越入场，内置止损、移动止盈、布林带带宽过滤与步进锁盈。
  • Guardian 策略：不主动开单，实时监听账户仓位并强制补挂/移动止损与动态止盈，防止裸奔。
  • 做市策略：支持双边追价、风险阈值控制与订单自愈。
  • 模块化架构：策略引擎、交易所适配器与 Ink CLI 相互解耦，新增交易所或策略更容易。

支持的交易所

交易所 合约类型 必填环境变量 备注
Aster USDT 永续 ASTER_API_KEY, ASTER_API_SECRET 默认交易所；兼容脚本引导
StandX USD 永续 STANDX_TOKEN 使用 JWT Token 登录，优先走 WebSocket 推送
GRVT USDT 永续 GRVT_API_KEY, GRVT_API_SECRET, GRVT_SUB_ACCOUNT_ID GRVT_ENV 可切换 prod/testnet
Lighter zkLighter 永续 LIGHTER_ACCOUNT_INDEX, LIGHTER_API_PRIVATE_KEY 默认 LIGHTER_ENV=testnet
Backpack USDC 永续 BACKPACK_API_KEY, BACKPACK_API_SECRET, BACKPACK_PASSWORD BACKPACK_SANDBOX=true 启用沙盒
Paradex StarkEx 永续 PARADEX_PRIVATE_KEY, PARADEX_WALLET_ADDRESS PARADEX_SANDBOX=true 使用测试网
Nado USDC 永续 NADO_SIGNER_PRIVATE_KEY, NADO_SUBACCOUNT_OWNER NADO_ENV 可切换 inkMainnet/inkTestnet

系统要求

  • Bun ≥ 1.2（需同时包含 bun、bunx 命令）
  • macOS、Linux 或 Windows (推荐 WSL)
  • Node.js 仅在部分工具链场景需要，可选

快速上手

一键脚本（macOS / Linux / WSL）

curl -fsSL https://github.com/discountry/ritmex-bot/raw/refs/heads/main/setup.sh | bash

脚本会安装 Bun、项目依赖，收集 Aster API 凭证，生成 .env 并启动 CLI。运行前请准备好对应交易所的 API Key/Secret。

手动安装

  1. 获取代码
    git clone https://github.com/discountry/ritmex-bot.git
cd ritmex-bot
    不便使用 Git 时，可在仓库页面下载 ZIP 后手动解压。
  2. 安装 Bun
    • macOS / Linux：curl -fsSL https://bun.sh/install | bash
    • Windows PowerShell：powershell -c "irm bun.sh/install.ps1 | iex" 安装完成后重新打开终端，确认 bun -v 正常输出版本号。
  3. 安装依赖
    bun install
  4. 复制环境变量模板并填写
    cp .env.example .env
    按下文指南修改 .env，至少需要正确配置一个交易所的凭证。
  5. 运行 CLI