blog.dopana

返回

你想在不打开浏览器的情况下从终端进行股票交易吗?Longbridge Terminal是一个用Rust构建的CLI工具,让你可以直接从命令行访问市场数据、管理投资组合和执行交易。它专门设计用于与AI代理配合工作,使自动交易比以往任何时候都更容易。

为什么需要Longbridge Terminal?#

传统股票交易通常需要:

  • Web浏览器:打开应用、登录、浏览多个屏幕
  • 移动应用:速度慢,不适合复杂任务
  • 电子表格:手动更新,非实时
  • 自定义API:编写自己的代码,管理身份验证

Longbridge Terminal通过提供全面的CLI解决这些问题:

  • 实时数据:报价、深度、K线、期权、权证
  • 完整交易:买入、卖出、取消、修改订单
  • 投资组合管理:资产、持仓、盈亏跟踪
  • AI友好:JSON输出、工具调用就绪
  • 交互式TUI:用于监控的全屏界面

Longbridge Terminal是什么?#

将Longbridge Terminal想象成股票交易的”瑞士军刀”。它是一个覆盖所有Longbridge OpenAPI端点的CLI:

  • 市场数据:实时报价、深度、K线、期权、权证
  • 投资组合:账户余额、股票持仓、基金持仓
  • 交易:订单提交、修改、取消、执行历史
  • 基本面:财务报告、分析师评级、估值
  • 新闻和信号:新闻文章、监管文件、策略信号

使用Rust构建:

  • Ratatui:TUI渲染框架
  • Tokio:异步运行时
  • Bevy ECS:实体组件系统架构
  • Longbridge SDK:官方OpenAPI SDK

安装#

安装很简单 - 只需一个命令:

macOS/Linux
brew install --cask longbridge/tap/longbridge-terminal
bash

或使用安装脚本:

macOS/Linux
curl -sSL https://github.com/longbridge/longbridge-terminal/raw/main/install | sh
bash

Windows:

iwr https://github.com/longbridge/longbridge-terminal/raw/main/install.ps1 | iex
powershell

身份验证#

使用OAuth 2.0 - 无需手动令牌管理:

longbridge auth login # 打开浏览器进行OAuth并保存令牌
longbridge auth logout # 清除保存的令牌
longbridge check # 验证令牌、区域和API连接
bash

CLI会自动检测你的区域(中国大陆使用.cn端点,其他使用全球端点)。

CLI使用#

命令结构:

longbridge <command> [options]
bash

所有命令都支持--format json以获得机器可读输出:

longbridge quote TSLA.US --format json
longbridge positions --format json | jq '.[] | {symbol, quantity}'
bash

Quotes - 市场数据#

# 实时报价
longbridge quote TSLA.US 700.HK

# 二级订单簿深度
longbridge depth TSLA.US

# K线(蜡烛图)数据
longbridge kline TSLA.US --period day

# 日内价格和成交量
longbridge intraday TSLA.US

# 静态参考信息
longbridge static TSLA.US NVDA.US
bash

输出示例:

$ longbridge static TSLA.US NVDA.US
| Symbol  | Last    | Prev Close | Open    | High    | Low     | Volume    | Turnover        | Status |
|---------|---------|------------|---------|---------|---------|-----------|-----------------|--------|
| TSLA.US | 395.560 | 391.200    | 396.220 | 403.730 | 394.420 | 58068343  | 23138752546.000 | Normal |
| NVDA.US | 183.220 | 180.250    | 182.970 | 188.880 | 181.410 | 217307380 | 40023702698.000 | Normal |
bash

Trading - 执行交易#

[!WARNING] 订单命令在第一次运行时总是试运行。它们只预览,不会实际下单。你需要使用--execute <CODE>再次运行以实际执行。

Portfolio - 资产管理#

# 资产概览
longbridge assets

# 投资组合概览
longbridge portfolio

# 当前持仓
longbridge positions

# 基金持仓
longbridge fund-positions

# 盈亏分析
longbridge profit-analysis
bash

Fundamentals - 财务分析#

# 财务报告
longbridge financial-report AAPL.US --kind IS

# 分析师评级
longbridge institution-rating AAPL.US

# 估值
longbridge valuation AAPL.US --indicator pe

# 股息历史
longbridge dividend AAPL.US
bash

TUI - 交互式界面#

使用美观的界面进行实时监控:

longbridge tui
bash

功能:

  • 实时监视列表
  • 蜡烛图
  • 投资组合视图
  • 股票搜索
  • Vim风格键绑定
  • 鼠标支持

AI Chat - LongbridgeAI#

与AI聊天进行市场分析:

longbridge ai
bash

功能:

  • 带Markdown的流式回答
  • 图表和表格
  • 实时报价卡片
  • 命令面板
  • 多行输入
  • 会话持久性

架构#

Longbridge TerminalCLI CommandsTUI InterfaceAI ChatJSON-RPC ServerQuote APITrade APIFundamentals APIRatatui TUIReal-time WebSocketLongbridgeAIMarkdown RenderingExternal AppsJSON-RPC 2.0Longbridge SDK

嵌入到其他应用#

将Longbridge Terminal集成到其他应用(桌面小部件、仪表板):

longbridge serve
bash

这会在stdin/stdout上打开JSON-RPC 2.0服务器:

→ {"jsonrpc":"2.0","id":1,"method":"quote.quote","params":{"symbols":["700.HK"]}}
← {"jsonrpc":"2.0","id":1","result":[{"symbol":"700.HK","last_done":"445.600", ...}]}
→ {"jsonrpc":"2.0","id":2,"method":"quote.subscribe","params":{"symbols":["700.HK"]}}
← {"jsonrpc":"2.0","id":2,"result":{"subscribed":[{"symbol":"700.HK"}]}}
← {"jsonrpc":"2.0","method":"quote.updated","params":{"symbol":"700.HK","last_done":"446.000"}}
json

AI代理集成#

Longbridge Terminal专门为AI代理设计。安装技能:

npx skills add longbridge/developers
bash

Claude可以查询市场数据、运行技术分析和管理交易:

claude> Show me TSLA and NVDA performance over the last 5 days
text

Claude将自动运行必要的CLI命令并返回结果。

Shell补全#

启用标签补全:

Bash
source <(longbridge completion bash)
bash
Zsh
source <(longbridge completion zsh)
bash
Fish
longbridge completion fish | source
bash

高级功能#

Grid Trading#

自动交易策略:

# 预览网格策略
longbridge grid submit 700.HK --base-price 300 --upper-price 360 --lower-price 240 \
  --trigger-type percent --trigger-up 2 --trigger-down 2 --quantity 100

# 实际提交
longbridge grid submit 700.HK --base-price 300 ... --execute 123
bash

Recurring Investment (DCA)#

定期自动投资:

# 创建每周DCA计划
longbridge dca create TSLA.US --amount 500 --frequency weekly --day-of-week mon

# 查看所有计划
longbridge dca

# 暂停计划
longbridge dca pause <PLAN_ID>
bash

Stock Screener#

查找符合条件的股票:

# 列出策略
longbridge screener strategies

# 运行自定义过滤器
longbridge screener search --market HK --filter filter_marketcap:100:1000 --filter filter_divyld:3
bash

与其他解决方案的比较#

功能Longbridge TerminalWeb AppMobile AppCustom API
语言Rust CLIWebMobileCustom
实时数据✓✓✓✓
脚本编写✓✗✗✓
AI集成✓✗✗可选
TUI界面✓✗✗✗
离线功能有限✗有限✓
学习曲线中等低低高

何时使用Longbridge Terminal?#

使用当:

  • 你更喜欢在终端工作
  • 需要自动交易的脚本
  • 想要与AI代理集成
  • 需要TUI进行实时监控
  • 是开发者或高级用户

不使用当:

  • 你是交易新手
  • 需要简单的GUI
  • 不熟悉命令行
  • 只需要基本交易功能

结论#

Longbridge Terminal是一个强大的工具,适用于想要从终端管理交易的交易者和开发者。通过CLI命令、TUI界面和AI集成的结合,它提供了Web应用或移动应用无法提供的灵活性。如果你是终端用户并且想要高效地进行股票交易,Longbridge Terminal值得考虑。

References#