获取 Webull 泰国账户中的订单与持仓记录

据 PR Newswire 一篇与其泰国上线相关的新闻稿，Webull Securities (Thailand) 到 2025 年初已录得超过 30 万注册用户——这些账户背后无一例外都对应着一套结构化的服务端记录：未平仓持仓、横跨四个股票市场的完整订单簿、按币种划分的现金，以及把资金转入券商实体的出入金流水。这正是投资组合工具、会计人员或资金看板想从 App 里取出的数据，而它们都不会以能直接读取的形式留在手机上。

App 对这些数据面的命名与任何券商无异——持仓页、带成交与时间戳的订单列表、资产汇总、出入金历史。我们在账户持有人授权的前提下，分析 App 自身使用的已认证会话来触达它们，并交回可按需拉取同样记录的源代码。对一个 Webull 泰国账户来说，订单历史是重心所在，因为它横跨美股、SET、香港和中国的交易——否则集成方只能靠手工把这些拼到一起。

账户里到底装着哪些数据

触达数据的路径

泰国没有像某些市场覆盖银行账户那样、面向消费者、覆盖证券账户的开放金融机制，因此投资者的券商数据只能通过账户本身触达，而非依靠监管强制的授权通道。真正适用于此的做法有三种。

对已认证 App 的协议分析

App 先给会话完成认证，随后为持仓、订单和余额交换结构化的报文。我们针对一个已授权的账户抓取这些流量，梳理请求与响应的结构，并用代码复现登录、令牌刷新和查询的调用序列。这条路径能触达横跨全部四个市场的完整订单簿，也是我们会据以搭建集成的方案。工作量适中；能维持多久取决于 App 前端改动的频率，这一点我们会计入后续维护。

用户授权的凭据接入

在账户持有人授权的情况下，集成以该用户的身份运行——与 App 会建立的会话相同，且经过范围限定与日志记录。这适合单账户或托管账户的场景，并与上面的协议工作天然契合。

原生对账单导出

App 本身已生成的对账单与成交确认，是获取周期性、文档级记录的低成本兜底方案。它们滞后于实时状态，也比订单流更粗，因此只能给集成打辅助，而非独当一面。

抓取过程示意

仅作示意——字段名与确切的认证链路会在实施阶段针对真实、已授权的账户逐一确认，并非在此断言。

# Session bootstrap, then a positions pull. Shapes verified during the build.
POST /account/session/refresh
  headers: { device-id, app-ver, access-token }
  body:    { refresh_token }
  -> 200   { access_token, expires_in, account_id }

GET /trade/positions?accountId={account_id}&assetType=ALL
  headers: { access-token }
  -> 200 {
       "positions": [
         { "symbol": "AAPL",  "market": "US",  "qty": 12,
           "avgCost": "188.40", "mktValue": "2410.80", "ccy": "USD" },
         { "symbol": "PTT",    "market": "SET", "qty": 500,
           "avgCost": "34.25",  "mktValue": "17500.00", "ccy": "THB" }
       ]
     }

# normalize on read: one schema across US / SET / HK / CN
def to_holding(row):
    return {
      "symbol":   row["symbol"],
      "venue":    row["market"],          # US | SET | HK | CN
      "quantity": float(row["qty"]),
      "value":    {"amount": row["mktValue"], "currency": row["ccy"]},
    }

# on 401, refresh once and replay; on repeated 401, re-consent.
      

你会拿到什么

交付物是一套可用的集成，而不是一份报告。对一个 Webull 泰国项目而言，这意味着：

• 一份 OpenAPI/Swagger 规范，描述我们复现的各个接口——持仓、订单、余额、出入金、对账单。
• 一份协议与认证流程报告，覆盖登录、令牌刷新与会话链路在这款 App 上的实际行为。
• 关键调用的可运行源代码（Python 或 Node.js），包含上文展示的跨市场归一化处理。
• 针对录制夹具、验证认证路径与订单/持仓拉取的自动化测试。
• 接口文档，外加一份对应 PDPA 的数据留存与授权撤回说明。

授权与 PDPA

在泰国，有两件事约束着这项工作。券商 Webull Securities (Thailand) 持有泰国 SEC 牌照；账户中的个人数据则受《个人数据保护法》（B.E. 2562）管辖，由 PDPC 负责执行。落到实处，就是我们所依据的合法性基础是账户持有人本人的授权——有记录、可撤回。我们记录访问了什么、何时访问，只触及某个用例真正需要的字段——税务导出用不到自选股——并在合作需要时签署保密协议。授权范围、有效期以及撤回路径都写进交接文档，好让集成能够干净地关停。

针对这款 App 的实现要点

有两处细节，决定了我们如何拼装一套 Webull 泰国集成。

• 四个市场，四套规则。美股、SET、香港与中国的交易各有不同的代码体系、交易时段和交收规则。我们在抓取时就把代码、币种和时间戳归一到同一套模型里，让一笔美股成交和一笔 SET 成交落在同一本账上，而不是散成四份互不兼容的导出。
• 24 小时交易与实时行情通道。App 主打全天候美股交易和实时行情，这些数据经推送通道到达，而非轮询。我们把行情流的抓取与定时的持仓、余额同步分开，并把同步时点安排在夜盘时段前后，避免盘中取到的快照悄悄变成过期数据。
• 通过指定实体出入金。正如 App 所述，资金经名为 “Webull Securities (Thailand) Co., Ltd.” 的账户划转。我们梳理划转与交收的各种状态，让出入金对账与券商自身的状态模型对得上。
• 前端漂移。券商 App 经常改版界面。当 App 前端发生变化时，我们会把重新抓取并比对接口差异作为持续维护的一部分，让集成跟上改动，而不是被改动打断。

获取一个已授权账户或沙箱的访问权限，会在启动阶段与你一起安排——这是项目的一部分，而不是开工前要先扫清的门槛。

价格

Webull 泰国集成的源代码交付 300 美元起，而且只有在可用代码到手、你也满意之后才付款。另一种是托管方式：调用我们的持仓、订单和余额接口，按调用计费，前期零投入。无论哪种，实施都按一到两周的周期推进。把 App 和你要从它的数据里得到什么告诉我们，剩下的交给我们——从 /contact.html 开始。

会在哪些地方用到

• 一款多券商投资组合 App，需要把 Webull 泰国的持仓和本地 SET 持仓并排放进同一个视图。
• 一套会计流程，每季度拉取跨市场订单历史用于资本利得申报。
• 一个资金看板，核对泰铢与美元现金以及转入券商账户的资金划转。
• 一款研究工具，直接取用用户已在 App 中关注的同一批自选股标的。

我们参考的界面

同一领域里的邻近应用

泰国投资者通常同时持有其中好几家的账户，这正是统一集成值得搭建的原因。此处列出仅供参照，并非排名。

• InnovestX — 本地股票、共同基金与数字资产集于一款 App；持仓与订单记录与 Webull 的相仿。
• Dime — 美股碎股与储蓄功能；按用户的持仓与现金值得汇聚。
• Streaming (Kasikorn Securities) — 老牌的 SET 交易前端；面向泰国股票的订单簿与投资组合数据。
• Liberator — 零佣金的泰国股票 App；账户持仓与交易历史藏在登录之后。
• Bualuang Securities — 银行系券商，提供 SET 交易与对账单归档。
• Interactive Brokers — 全球多资产账户；覆盖众多交易场所的深度持仓与订单数据。
• Saxo — 全球交易平台，覆盖多币种现金与多种金融工具。
• SCB (SCBS / InnovestX legacy) — 银行券商的股票账户，含订单与余额记录。

集成方常问的问题

美股、泰股、港股和中国市场的交易能汇成一条归一化的订单流吗？

可以。App 持有横跨全部四个市场的订单，每个市场各有自己的代码体系、交易日历和交收惯例。我们把代码、币种和时间戳归一到同一套模型，让一笔美股成交和一笔 SET 成交能在同一本账上对上。

实时的 24 小时行情流与收盘快照分别如何处理？

Webull 泰国主打 24 小时美股交易和实时行情，这些数据经推送通道到达，而非简单轮询。我们把行情流通道与周期性的持仓、余额同步分开抓取，让行情保持实时，同时按适合夜盘时段的节奏拉取账户状态。

哪家监管机构与哪部隐私法律会左右一套 Webull 泰国集成？

Webull Securities (Thailand) 在泰国 SEC 监管下运营，个人数据受泰国《个人数据保护法》（PDPA，B.E. 2562）管辖。我们以账户持有人的授权为依据，记录访问，并把触及的数据字段压缩到用例所需的范围。

在不四处散布原始凭据的前提下，你们如何触达账户？

访问权限会在启动阶段针对一个已授权账户与你一起安排。我们把会话与令牌材料保存在范围受限、带日志的存储中，只拉取集成所需的字段，并把留存与撤回路径写成文档，让授权可以被撤回。

信息来源与核对人

2026 年 6 月，对照 App 的 Play Store 页面、运营方的上线公告以及泰国数据保护相关指引进行核对。查阅的第一手来源： Google Play 页面（org.dayup.stocks.th）、 PR Newswire — Webull 泰国上线、 泰国证券交易所隐私声明，以及 PwC 对泰国 PDPA 的解读。

由 OpenBanking Studio 集成团队梳理，2026 年 6 月。