LongTrader 介绍¶
给想把执行权握在自己手里的人用的交易客户端。
LongTrader 切成两层。
你跑的那层是开源的:
策略宿主 longtrader-worker、
命令行工具 longtrader-cli、
以及 Rust / Python / TypeScript / Go 四套 SDK。
我们跑的那层不开源: 场所适配、订单路由、风控和状态机。
两层之间只用一份公开的 protobuf 契约说话。 契约是版本化的。 改坏了由 CI 拦下来, 不是让你的策略在凌晨三点替你发现。
为什么这么切¶
自己接过交易所 API 的人都清楚痛在哪: 四十个场所四十套脾气, REST 限频、WebSocket 断连、部分成交、余额漂移, 还有那句最贵的疑问——我刚才那一单到底发出去没有。
LongTrader 把这些收进平台层。
你面对的只有两个 trait:
TradingGateway 和 MarketDataSource。
代价也讲清楚: 策略跑在你的机器上, 但订单是从我们的服务出去的。 对这件事零容忍的人, 别用—— 自己去写接入,也别抱怨。
三条入口,同一套契约¶
| 入口 | 适合谁 | 你要做的事 |
|---|---|---|
longtrader-cli |
想用命令行管账户的人,想让 AI Agent 下单的人 | 背下一个二进制,其余交给脚本 |
longtrader-worker |
会写代码、要自己实现策略逻辑的人 | 实现两个 trait,或者从 22 个内置策略里挑一个 |
| LongTrader Terminal | 想看图、看订单流、手动下单的人 | 打开桌面终端,剩下的点鼠标 |
三条路互不排斥。 CLI 能启动 Worker 里的策略, Terminal 同时就是 CLI 和 Worker 连的那个 API 服务端。
数据怎么流¶
Text Only
What you run (open source)
longtrader-worker strategy host: built-in strategies or your own code
longtrader-cli command line: accounts, orders, market data, streams
|
| ConnectRPC · application/proto · Bearer token
v
What the platform runs
longtrader-api the unified service endpoint
LongTrader Terminal desktop terminal + API server
|
v
CEX (Binance / OKX / Bybit / Hyperliquid …)
DEX (Uniswap / Curve / Raydium / Jupiter …)
连接是向外的。 你的机器主动拨出去, 没有东西主动拨进来。
它不做什么¶
- 不给你 Alpha。 策略逻辑是你写的,亏了钱别赖框架。
- 不托管你的资金和密钥。 Token 从你自己指定的文件里读,不进日志,服务端常量时间比对。
- 不做信号服务,也不做跟单。 它是你的决策和交易所之间的那一层,不是替你决策的那一层。
信号灯给你了, 油门刹车也在你脚下, 撞了算你的。
下一步¶
- 架构 — 四层结构、会话状态机、端口与适配器
- 快速上手 — 十分钟内把第一条策略送上 mock 场所
- 策略目录 — 22 个内置策略按类别列全
- CLI 参考 — 18 个命令、全局参数、时间周期与订阅主题
- 为什么选 LongTrader — Bot 和系统的分水岭
许可证¶
Apache-2.0。