In the DeepSeek Harness (DSH) plugin ecosystem, accessing real-time data is a key part of extending agent capabilities. For developers or users working with financial scenarios, dsh-market-watch provides the first feature set dedicated to financial market data. It does not rely on expensive private interfaces; instead, it uses free public data sources (such as Tencent Finance and CoinGecko) to provide market quotes, watchlist management, and chart visualization.

Plugin Overview

dsh-market-watch is a financial monitoring toolkit designed primarily to meet the need for real-time tracking of stocks, indexes, and cryptocurrencies locally or within the DSH environment.

  • Core value: Provides real-time quotes, locally persisted watchlists, threshold alerts, periodic polling, and ASCII/Mermaid charts based on free data sources.
  • Maintainer: JohnXu22786
  • License: MIT

Core Features

The plugin provides the following capabilities through the DSH tool system and a standalone command-line interface (CLI):

  1. Real-time quotes: Supports A-shares (Shanghai Stock Exchange/Shenzhen Stock Exchange/Beijing Stock Exchange), indexes, and cryptocurrencies. Data is mainly sourced from Tencent Finance’s free APIs and the CoinGecko public API.
  2. Local watchlists: Persistently stores watched lists locally (code/name/market/type). The plugin and CLI share the same data source, and changes take effect without restarting.
  3. Threshold alerts: Supports trigger conditions based on price or percentage change (gt/gte/lt/lte). Alerts are triggered with each poll and support a cooldown period to prevent excessive notifications.
  4. Periodic polling: Includes a built-in timer to automatically refresh the watchlist. The polling logic drops overlapping requests and is designed to be considerate of free data sources.
  5. Chart rendering: Supports rendering ASCII bar charts, line charts, and Mermaid xychart-beta charts in chat.

Installation and Enablement

Before installing, ensure your environment meets the following dependency requirements:

  • Node.js: Version must be ^22.19 || >=24
  • DeepSeek Harness (dsh): Version must be >=0.1.0-rc.6
  • Profile: Use the web or headless profile

The installation process is as follows:

  1. Ensure Node.js and dsh are installed.
  2. Clone or place the plugin code into a local directory.
  3. Run the installation command in that directory:
dsh plugin --profile web add .

After successful installation, the plugin is automatically registered in the DSH configuration and takes effect after a restart. You can verify that the plugin is correctly loaded by running dsh config dump | grep market-watch.

Typical Usage

The plugin provides 6 DSH tools and a standalone set of CLI tools, and they operate on the same data directory.

Command-Line Interface (CLI)

dsh-market-watch is a standalone command-line program suitable for manual execution in a terminal:

  • Query market quotes:
    dsh-market-watch quote sh600000 bitcoin --days 5

This outputs the latest quotes for SPD Bank (600000) and Bitcoin, along with a mini trend chart for the last 5 days.
  • Manage watchlists:
    dsh-market-watch watch sh600000 bitcoin --name "BTC"

Add a stock code and currency to the local watchlist.
  • View list:
    dsh-market-watch list
  • Manage alerts:
    dsh-market-watch alert add bitcoin --field price --op gte --value 70000 --cooldown 600

Set an alert to trigger when the Bitcoin price reaches 70000, with a cooldown of 600 seconds.
  • Draw charts:
    dsh-market-watch chart sh600000 --days 30 --format mermaid

Generate a 30-day chart in Mermaid format.
  • Execute a single poll:
    dsh-market-watch poll --once

DSH Tools

The plugin registers the following tools, which agents can invoke directly during conversations:

  • quote: Query the latest quote.
  • list: List the current watchlist.
  • watch: Add a watched asset.
  • unwatch: Remove a watched asset.
  • alert: Manage alert rules.
  • chart: Generate a chart.

Use Cases and Important Notes

Use cases:
* Users who need to track A-shares or cryptocurrencies in real time within the DSH environment.
* Building agents with financial monitoring capabilities.
* Developers who need to persistently store trading plans or watchlists locally.

Important notes:

  1. Data latency: Because free public data sources are used, market quotes may be delayed by seconds to minutes and are not equivalent to real-time exchange matching prices.
  2. Data sources:
    • A-shares/indexes: Tencent Finance API.
    • Cryptocurrencies: CoinGecko public API (note the rate limits on the free tier).
  3. Investment advice: All data provided by this plugin is free public data and does not constitute any investment advice. Do not make trading decisions based solely on delayed data.

Conclusion

dsh-market-watch introduces financial data capabilities to the DSH ecosystem. With dual entry points through the CLI and tool system, it provides a complete closed loop from querying to visualization. For developers working with financial scenarios, this is a ready-to-use tool. For more details and source code, refer to the plugin directory or the GitHub repository.