dsh-trading212

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# dsh × Trading 212

[English](README.md) | [简体中文](README.zh-CN.md)

[![npm version](https://img.shields.io/npm/v/dsh-trading212.svg)](https://www.npmjs.com/package/dsh-trading212)

A read-only Trading 212 portfolio workspace for **dsh**. Configure your API credentials once, then inspect your holdings, transaction history, portfolio risks, and stock-level trade markers—or ask questions about your portfolio in any dsh conversation.

> For personal research and information only. This plugin does not provide investment advice and cannot place, modify, or cancel orders.

![Real dsh Trading 212 dashboard settings screen with no account values, positions, identity, or credentials shown](https://raw.githubusercontent.com/Kevoyuan/dsh-trading212/main/docs/images/dashboard-settings.png)

*Real product screenshot. No account value, position, personal identity, API key, or API secret is shown.*

## Features

- Guided Demo or Live API setup with persistent dsh credential storage
- Portfolio value, cash, returns, FX impact, concentration, and pending-order overview
- Holdings, order history, cash transactions, and dividends
- ECharts stock price history with actual Trading 212 buy and sell fills overlaid
- English and Chinese UI that follows dsh by default, with a manual override in Settings
- Read-only `trading212_portfolio` and `trading212_history` tools for normal dsh conversations
- Sanitized errors for authentication, permission, rate-limit, timeout, and upstream failures

## Quick start

### Requirements

1. A working dsh installation.
2. A Trading 212 API key and API secret. Start with a **Demo** key if possible.

### Install

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

Fully quit and reopen dsh. Use the `dsh / T212` switcher in the lower-left sidebar to open the dashboard.

Alternatively, download the `.tgz` package from [GitHub Releases](https://github.com/Kevoyuan/dsh-trading212/releases) and install it locally:

```bash
dsh plugin --profile web add --save-exact ./dsh-trading212-.tgz
```

### Connect Trading 212

1. Open the `T212` dashboard and select the Demo or Live environment.
2. Paste your API key and API secret, then select **Test and save**.
3. Open the dashboard or return to dsh and ask a portfolio question.

Grant read-only access to:

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

Do not grant permission to place, modify, or cancel orders. Trading 212 displays an API secret only once; create a new key if the secret is lost.

Official English documentation: [Trading 212 API documentation](https://docs.trading212.com/api/orders) · [How can I generate an API key?](https://helpcentre.trading212.com/hc/en-us/articles/14584770928157-How-can-I-generate-an-API-key) · [dsh plugin development guide](https://deepseek-harness.github.io/deepseek-harness/develop/basic/)

## Ask from dsh

Example prompts:

```text
Summarize my three largest positions and concentration risk.
```

```text
Which positions are dragging down my unrealized return?
```

```text
What currency exposure do I have, and are any orders still pending?
```

dsh calls the read-only tools when needed and receives normalized portfolio data. The plugin does not register any trading action.

## Data and privacy

| Source | Purpose | Data sent |
| --- | --- | --- |
| Official Trading 212 API | Account, positions, orders, fills, cash transactions, and dividends | API key and secret are used only to authenticate with Trading 212 |
| Unofficial Yahoo Finance endpoint | Daily historical prices for individual stocks | Public instrument identifiers only; no credentials, quantities, or account values |

Historical market prices may be delayed, incomplete, or temporarily unavailable. Trading 212 holdings and execution history remain available when Yahoo Finance fails.

## Development

```bash
pnpm install
pnpm typecheck
pnpm test
pnpm pack --pack-destination dist
```

Main directories:

- `src/index.ts`: dsh host, HTTP API, and read-only tools
- `src/portfolio-service.ts`: credential persistence, caching, and request coordination
- `src/trading212.ts`: Trading 212 client and response validation
- `src/market-data.ts`: Yahoo Finance historical market data
- `src/client/index.tsx`: dsh sidebar switcher and dashboard overlay
- `src/app/`: setup, portfolio, history, and instrument UI

## Contributing

Issues and pull requests are welcome. Never include an API key, API secret, real account value, or real portfolio position in issues, screenshots, fixtures, or commits.

## License

Licensed under the [MIT License](LICENSE).