取出 Webull Thailand 账户里的订单与持仓记录

据一篇配合泰国上线发布的 PR Newswire 稿件，Webull Securities (Thailand) 到 2025 年初已录得逾 30 万注册用户——这每一个账户背后，都对应着一套结构化的服务端记录：未平仓头寸、横跨四个股票市场的完整订单簿、按币种分列的现金，以及把资金转入券商主体的出入金流水。这正是投资组合工具、会计人员或资金看板想从 App 里拿到的数据，而它们没有一样是以能直接读出的形式存在手机上的。

这个 App 对这些数据面的命名和任何券商一样——一个持仓页、一份带成交与时间戳的订单列表、一张资产汇总、一条存取款历史。我们的做法是在账户持有人授权下，分析 App 自身使用的已认证会话，再交回一套能按需拉取同样记录的源代码。对一个 Webull Thailand 账户来说，订单历史是重心所在，因为它把美股、SET、港股和 A 股的交易都装在一起，否则对接方就得靠人工去逐一拼接。

账户里究竟存了什么

拿到数据的几条路

泰国没有像某些市场覆盖银行账户那样、覆盖证券账户的面向消费者的开放金融方案，所以投资者的券商数据要通过账户本身来读取，而不是靠监管强制的授权通道。这里真正适用的有三种方式。

对已认证 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 Thailand 项目，这意味着：

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

授权与 PDPA

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

针对本应用的实现要点

有两处细节决定了 Webull Thailand 对接该怎么搭。

• 四个市场，四套规则。美股、SET、港股和 A 股的交易在代码体系、交易时段和结算规则上各不相同。我们在采集时就把代码、币种和时间戳归一到一套 schema，让一笔美股成交和一笔 SET 成交落进同一本账，而不是散成四份互不兼容的导出。
• 24 小时会话与实时行情通道。App 主打全天候美股交易和实时报价，这些行情走的是推送通道，而非轮询。我们把行情流采集与定时的持仓、余额同步分开，并把同步节奏卡在夜盘前后，避免盘中取的快照悄悄失效。
• 资金经具名主体流转。如 App 所述，资金通过名为"Webull Securities (Thailand) Co., Ltd."的账户进出。我们会映射转账与交收状态，让出入金对账与券商自己的状态模型对齐。
• 前端漂移。券商 App 常常重排界面。当前端一变，我们会重跑采集、对端点做 diff，作为持续维护的一部分，让对接跟着变化走，而不是一变就断。

访问一个已授权账户或沙箱，会在对接启动阶段与你一起安排——它是项目的一部分，而不是开工前必须先清掉的门槛。

价格

Webull Thailand 对接的源代码交付 300 美元起，而且只有在可用代码交到你手上、你也认可之后才付。另一条路是托管方式：调用我们为持仓、订单和余额提供的端点，按次计费，无需预付。无论哪条路，搭建都按一到两周的周期推进。把 App 和你要从它数据里得到什么告诉我们，剩下的交给我们——从 /contact.html 开始。

它会被用在哪里

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

我们参考的界面

同一领域的相邻应用

泰国投资者通常同时持有下面几家的账户，正因如此，做一套统一对接才有价值。此处列举只为提供背景，并非排名。

• InnovestX — 一个 App 里囊括本地股票、共同基金与数字资产；持仓和订单记录与 Webull 的相近。
• Dime — 提供美股零股与储蓄功能；按用户的持仓与现金值得聚合。
• Streaming (Kasikorn Securities) — 老牌的 SET 交易前端；泰股的订单簿与投资组合数据。
• Liberator — 免佣金的泰股 App；登录后可见账户持仓与交易历史。
• Bualuang Securities — 银行系券商，含 SET 交易与对账单归档。
• Interactive Brokers — 全球多资产账户；跨众多交易场所的深度持仓与订单数据。
• Saxo — 全球交易平台，覆盖多币种现金与多品种标的。
• SCB (SCBS / InnovestX legacy) — 银行系券商股票账户，含订单与余额记录。

对接方常问的问题

美股、泰股、港股和 A 股的成交能否汇成一条统一的订单流？

可以。这个 App 里同时存着四个市场的订单，每个市场都有自己的代码体系、交易日历和结算规则。我们会把代码、币种和时间戳统一到一套 schema，让一笔美股成交和一笔 SET 成交能对进同一本账。

实时、24 小时的行情推送和日终快照分别怎么处理？

Webull Thailand 主打 24 小时美股交易和实时报价，这类行情走的是推送通道，而不是简单轮询。我们把行情流通道和周期性的持仓、余额同步分开采集，让报价保持实时，同时按适配夜盘的节奏定时拉取账户状态。

Webull Thailand 的对接受哪个监管机构和隐私法约束？

Webull Securities (Thailand) 受泰国 SEC 监管，账户中的个人数据则适用泰国《个人数据保护法》（PDPA, B.E. 2562）。我们以账户持有人的授权为依据开展工作，记录访问日志，并把接触的数据字段压缩到用例真正需要的范围。

在不让原始凭证四处扩散的前提下，你们如何访问账户？

访问方式在对接启动阶段与你一起针对一个已授权账户约定。我们把会话和令牌材料存放在受限、可审计的存储里，只拉取对接所需的字段，并给出留存与撤销路径，使授权可以随时收回。

来源与核查人

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

由 OpenBanking Studio 对接团队梳理，2026 年 6 月。