Skip to content

dsh-trading212

Verified

dsh-trading212 · v0.7.0 · MIT · Web UI

Read-only Trading 212 portfolio workspace for dsh

Install

dsh plugin add dsh-trading212

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

dsh × Trading 212

English | 简体中文

npm version

dsh 里直接查看自己的 Trading 212 投资组合,并用自然语言提问。只读、低门槛:配置一次 API 密钥后,就能看持仓、历史成交、风险概览和个股买卖点。

仅供个人信息整理与研究参考,不构成投资建议。本插件不会下单、修改或取消订单。

真实 dsh Trading 212 dashboard 连接设置界面;未展示账户金额、持仓、姓名或密钥

真实产品界面截图;画面不包含账户金额、持仓、姓名或 API 密钥。

能做什么

  • 在 dsh 中完成 Demo / Live API 配置;刷新后仍会恢复连接状态
  • 一眼查看账户总览、现金、收益、外汇影响、集中度和待处理订单
  • 查看持仓、历史订单、资金流水与分红
  • 点击个股查看价格曲线,并叠加 Trading 212 的真实买入/卖出成交点
  • 中英双语界面,默认跟随 dsh 界面语言,也可在设置中手动切换
  • 在 dsh 对话中询问自己的组合,例如最大持仓、风险、货币敞口和未成交订单
  • 凭据由 dsh 的 credential provider 保存;不会写入 URL、浏览器存储、日志或 tool 输出

3 分钟开始

你需要准备

  1. 已安装并可打开 dsh。
  2. 一个 Trading 212 API Key 和 API Secret。建议先创建 Demo 环境密钥。

安装插件

直接执行:

dsh plugin --profile web add --save-exact dsh-trading212@latest

然后完全退出并重新打开 dsh。侧边栏左下会出现 dsh / T212 切换器,点击 T212 即可打开 dashboard。

也可以从 GitHub Releases 下载 .tgz,然后安装本地文件:

dsh plugin --profile web add --save-exact ./dsh-trading212-<version>.tgz

连接账户

  1. 打开 T212 dashboard,选择 DemoLive
  2. 粘贴 API Key 和 API Secret,点击“测试并保存”。
  3. 验证成功后即可查看 dashboard,或回到 dsh 开始对话。

创建密钥时仅授予以下读取权限:

  • Account data / account summary
  • Portfolio / positions
  • Orders / history

不要授予下单、修改或取消订单权限。Trading 212 的 Secret 只显示一次,遗失后需要重新创建。

英文官方说明:Trading 212 API documentation · How can I generate an API key? · dsh plugin development guide

在 dsh 中提问

直接在任意 dsh 对话里说:

总结我最大的三个持仓和集中度风险。
哪些仓位正在拖累未实现收益?
我的组合有哪些货币敞口?有没有还没成交的订单?

dsh 会按需调用只读的 trading212_portfoliotrading212_history tools,返回规范化的账户数据。插件不会注册交易指令。

数据与隐私

数据 用途 会发送什么
Trading 212 官方 API 账户、持仓、订单、成交、资金流水、分红 API Key / Secret 仅用于向 Trading 212 验证
Yahoo Finance 非官方接口 个股每日历史价格曲线 仅发送公开标的标识;不发送凭据、数量或账户金额

历史价格可能延迟、缺失或暂时不可用;即使 Yahoo Finance 不可用,Trading 212 的持仓与成交记录仍可查看。

本地构建(开发者)

pnpm install
pnpm typecheck
pnpm test
pnpm pack --pack-destination dist
dsh plugin --profile web add --save-exact ./dist/dsh-trading212-<version>.tgz

代码结构:

  • src/index.ts:dsh host、HTTP API 与只读 tools
  • src/portfolio-service.ts:凭据持久化、缓存与请求协调
  • src/trading212.ts:Trading 212 API 客户端与响应校验
  • src/market-data.ts:Yahoo Finance 历史价格数据
  • src/client/index.tsx:dsh 侧边栏 switcher 与 dashboard overlay
  • src/app/:连接、组合、历史和个股详情 UI

贡献

欢迎提交 issue 或 pull request。请勿在 issue、截图、测试 fixture 或提交记录中包含 API Key、API Secret、真实账户金额或持仓数据。

许可证

本项目采用 MIT License 开源。