Futu Stock for Openclaw

A comprehensive stock market data skill for accessing real-time HK, US, and CN quotes, options, and account info via the Futu OpenAPI.

shuizhengqi1
v1.0.4
Mar 2, 2026
4
2k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install futu-stock

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install futu-stock using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Futu Stock?

Futu Stock is a professional-grade skill designed to bridge AI agents with the Futu OpenAPI using the Model Context Protocol (MCP). It enables developers and traders to programmatically access real-time market data across Hong Kong, United States, and Chinese mainland markets, providing a robust interface for quotes, snapshots, and historical K-lines.

By integrating this capability into Openclaw Skills, users can create intelligent trading assistants that not only monitor market fluctuations but also manage portfolios and screen stocks based on complex criteria. The skill acts as a secure intermediary, allowing for both simulated and real trading environments while maintaining strict control over trading permissions.

Futu Stock Use Cases

  • Automated monitoring of real-time stock quotes for HK, US, and CN markets.
  • Generating technical analysis reports using historical K-line data for specific date ranges.
  • Managing trading accounts, checking available funds, and monitoring open positions.
  • Filtering stocks based on custom price, volume, or change percentage thresholds using advanced screening tools.
  • Analyzing option chains and expiration dates to execute complex hedging strategies.

How Futu Stock Works

  1. The agent performs an environment check to ensure python3, the futu-mcp-server package, and the Futu OpenD gateway are available.
  2. The skill establishes a secure connection to the local OpenD instance using the configured FUTU_HOST and FUTU_PORT.
  3. For specific securities, the skill invokes tools like get_stock_quote or get_market_snapshot using standardized market prefixes.
  4. For discovery queries, the get_stock_filter tool applies multi-parameter screening logic to identify securities meeting the user's criteria.
  5. The skill manages the lifecycle of subscription-based data, ensuring QUOTE or TICKER data is active before retrieval.

Futu Stock Setup

First, ensure the Futu OpenD gateway is installed and running on your local machine. Then, install the required MCP server packages:

pipx install futu-stock-mcp-server
pip install mcp

Configure your Openclaw Skills environment in your configuration file (~/.openclaw/openclaw.json):

{
  "skills": {
    "entries": {
      "futu-stock": {
        "enabled": true,
        "env": {
          "FUTU_HOST": "127.0.0.1",
          "FUTU_PORT": "11111",
          "FUTU_TRADE_ENV": "SIMULATE",
          "FUTU_TRD_MARKET": "HK",
          "FUTU_ENABLE_TRADING": "0"
        }
      }
    }
  }
}

Futu Stock Data Schema & Taxonomy

The skill organizes financial data into structured entities. Note that stock symbols must follow the {Market}.{Code} format.

Data Category Tools Used Metadata / Fields
Market Quotes get_stock_quote, get_market_snapshot symbol, last_price, volume, turn_over
Historical Data get_history_kline open, close, high, low, ktype (K_DAY, K_1M)
Derivatives get_option_chain, get_option_expiration_date strike_price, expiry_date, call_put_type
Account Info get_funds, get_positions power, frozen_cash, market_val, qty
Market State get_market_state, get_security_info market_status, lot_size, stock_name

Futu Stock Advanced Features

  • Automatic OpenD Gateway startup via the OPEND_PATH environment variable integration.
  • Dual-environment support for REAL and SIMULATE trading to ensure safe strategy testing.
  • Advanced stock screening with get_stock_filter supporting up to 250 custom filter conditions.
  • Real-time subscription management for high-frequency data like order books and broker queues.
  • Specialized option strategy modeling including Butterfly and Condor pricing tools.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins python3futu-mcp-server
Github Stars: 0
forks: 0

Featured*