跳转至

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 从你自己指定的文件里读,不进日志,服务端常量时间比对。
  • 不做信号服务,也不做跟单。 它是你的决策和交易所之间的那一层,不是替你决策的那一层。

信号灯给你了, 油门刹车也在你脚下, 撞了算你的。

下一步

许可证

Apache-2.0。