Skip to content

[Feature Request] Add Longbridge as a built-in Equity market data provider #139

@Jubeing

Description

@Jubeing

Summary

Longbridge(长桥证券)是一个支持港股、美股、A股(沪股通、深股通)、新加坡股等多市场的券商,同时提供丰富的 market data API。建议将 Longbridge 作为内置的 Equity 数据提供商接入 OpenAlice,与现有的 FMP/yfinance 平行运作。

Motivation

目前 OpenAlice 的 Equity 数据源主要依赖:

  • FMP — 美股数据为主,港股/A股覆盖有限
  • yfinance — 实时性不足,无港股实时行情

Longbridge 的优势:

能力 Longbridge FMP yfinance
港股实时行情 ✅ 五档盘口 + Level 2
美股实时行情 ✅(延迟)
A股(SH/SZ) ✅ 沪股通/深股通 ✅(延迟)
新加坡股 部分
交易执行 ✅ 原生支持
分析师评级
财务报表
资本流向
持仓/账户

Longbridge 的行情 API 覆盖了 FMP 的主要功能(财务报表、分析师评级、估值、分红),同时还提供港股特有的 broker queue(券商队列)Level 2 行情逐笔成交等数据。

Proposed Solution

建议在 OpenAlice 中添加 longbridge 作为内置 Market Data Provider,类似于现有的 fmpyfinance 配置项:

// data/config/market-data.json
{
  "providers": {
    "equity": "longbridge",
    "crypto": "yfinance",
    "currency": "yfinance",
    "commodity": "yfinance"
  },
  "providerKeys": {
    "longbridge": {
      "appKey": "...",
      "appSecret": "...",
      "accessToken": "..."
    }
  }
}

实现方案

已有社区实现证明方案可行:@Jubeing/openalice-longbridge-broker

该仓库包含:

  • LongbridgeBroker — 完整的 IBroker 接口实现,支持下单/改单/撤单/持仓查询/账户余额
  • 实时行情 — 通过 getQuote() 提供五档盘口、成交量、时间戳
  • 市场时钟 — 通过 getMarketClock() 返回各市场交易时段

核心文件(参考)

文件 说明
src/domain/trading/brokers/longbridge/LongbridgeBroker.ts 638 行,IBroker 完整实现
src/domain/trading/brokers/longbridge/longbridge-contracts.ts 标的符号映射、中文名称注册表
src/domain/trading/brokers/longbridge/longbridge-types.ts TypeScript 类型定义

集成点

  1. credential-map.ts — 添加 longbridge 映射到 LONGBRIDGE_APP_KEY/SECRET/TOKEN
  2. routeMap — 注册 longbridge equity 模型(quote、financial、valuation 等)
  3. SDKBaseClient — 添加 Longbridge HTTP 客户端作为 Executor
  4. accounts.json — broker 配置支持 type: "longbridge"

额外价值

  • 零额外费用 — Longbridge API 对已开通权限的账号免费
  • 港股专属数据 — broker queue、Level 2、逐笔成交,FMP/yfinance 均无法提供
  • 一套凭证同时解决行情 + 交易,无需维护多套 API key

Scope

  • 添加 Longbridge credential 解析(credential-map.ts)
  • 实现 Longbridge HTTP 客户端(支持 equity quote/financial/valuation 等模型)
  • providers.equity 配置项中支持 "longbridge"
  • 注册 longbridge broker 类型(已在社区分支中实现,可直接参考)

References

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions