跳转至

新闻 / 公告

MCP 工具总览

futu_search_news

  • Scope: qot:read
  • Python SDK 等价: —
  • 路由: MCP JSON-RPC tools/call name = "futu_search_news"

说明:

Search news, notices, and ratings. Public QOT 3263. c2s_json uses Qot_GetSearchNews.C2S JSON.

请求参数:

字段 类型 必填 Alias 说明
c2s_json string ✅ — Official generated C2S JSON. Field names use generated proto serde snake_case, e.g. multi_legs / combo_legs / order_type.
api_key string? — — Optional per-call API key plaintext. HTTP scope mode still requires a valid Bearer on every /mcp request; this field overrides that identity for the tool handler. In stdio mode: tool argument > startup key.

⚠️ 未知字段: 启用 deny_unknown_fields — 任何未在表里的字段会返 unknown field error（之前静默 drop）。

JSON-RPC 调用示例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "futu_search_news",
    "arguments": {
      "c2s_json": "…",
      "api_key": "optional-per-call-api-key"
    }
  }
}

返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。

futu_get_hot_news

  • Scope: qot:read
  • Python SDK 等价: —
  • 路由: MCP JSON-RPC tools/call name = "futu_get_hot_news"

说明:

Get structured hot news (page_size 1..50). Controlled by --extended-data-reads; default ON; live backend unverified.

请求参数:

字段 类型 必填 Alias 说明
c2s_json string ✅ — Official generated C2S JSON. Field names use generated proto serde snake_case, e.g. multi_legs / combo_legs / order_type.
api_key string? — — Optional per-call API key plaintext. HTTP scope mode still requires a valid Bearer on every /mcp request; this field overrides that identity for the tool handler. In stdio mode: tool argument > startup key.

⚠️ 未知字段: 启用 deny_unknown_fields — 任何未在表里的字段会返 unknown field error（之前静默 drop）。

JSON-RPC 调用示例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "futu_get_hot_news",
    "arguments": {
      "c2s_json": "{\"page_size\":20,\"extension_version\":1}",
      "api_key": "optional-per-call-api-key"
    }
  }
}

返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。

futu_get_latest_news

  • Scope: qot:read
  • Python SDK 等价: —
  • 路由: MCP JSON-RPC tools/call name = "futu_get_latest_news"

说明:

Get latest news with older/newer cursors and optional read-only filter sidecars. Controlled by --extended-data-reads; default ON; live backend unverified.

请求参数:

字段 类型 必填 Alias 说明
c2s_json string ✅ — Official generated C2S JSON. Field names use generated proto serde snake_case, e.g. multi_legs / combo_legs / order_type.
api_key string? — — Optional per-call API key plaintext. HTTP scope mode still requires a valid Bearer on every /mcp request; this field overrides that identity for the tool handler. In stdio mode: tool argument > startup key.

⚠️ 未知字段: 启用 deny_unknown_fields — 任何未在表里的字段会返 unknown field error（之前静默 drop）。

JSON-RPC 调用示例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "futu_get_latest_news",
    "arguments": {
      "c2s_json": "{\"page_size\":20,\"seq_mark\":\"\",\"page_flip\":0,\"tag_indexes\":[0],\"extension_version\":1}",
      "api_key": "optional-per-call-api-key"
    }
  }
}

返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。

futu_get_watchlist_news

  • Scope: qot:read
  • Python SDK 等价: —
  • 路由: MCP JSON-RPC tools/call name = "futu_get_watchlist_news"

说明:

Get news for explicit nonempty watchlist stock IDs; never falls back to the whole market. Controlled by --extended-data-reads; default ON; live backend unverified.

请求参数:

字段 类型 必填 Alias 说明
c2s_json string ✅ — Official generated C2S JSON. Field names use generated proto serde snake_case, e.g. multi_legs / combo_legs / order_type.
api_key string? — — Optional per-call API key plaintext. HTTP scope mode still requires a valid Bearer on every /mcp request; this field overrides that identity for the tool handler. In stdio mode: tool argument > startup key.

⚠️ 未知字段: 启用 deny_unknown_fields — 任何未在表里的字段会返 unknown field error（之前静默 drop）。

JSON-RPC 调用示例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "futu_get_watchlist_news",
    "arguments": {
      "c2s_json": "{\"page_size\":20,\"seq_mark\":\"\",\"stock_ids\":[7000700],\"extension_version\":1}",
      "api_key": "optional-per-call-api-key"
    }
  }
}

返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。

futu_get_watchlist_announcement

  • Scope: qot:read
  • Python SDK 等价: —
  • 路由: MCP JSON-RPC tools/call name = "futu_get_watchlist_announcement"

说明:

Get announcements for explicit stock IDs and notice types 0..5 (0 alone means all). Controlled by --extended-data-reads; default ON; live backend unverified.

请求参数:

字段 类型 必填 Alias 说明
c2s_json string ✅ — Official generated C2S JSON. Field names use generated proto serde snake_case, e.g. multi_legs / combo_legs / order_type.
api_key string? — — Optional per-call API key plaintext. HTTP scope mode still requires a valid Bearer on every /mcp request; this field overrides that identity for the tool handler. In stdio mode: tool argument > startup key.

⚠️ 未知字段: 启用 deny_unknown_fields — 任何未在表里的字段会返 unknown field error（之前静默 drop）。

JSON-RPC 调用示例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "futu_get_watchlist_announcement",
    "arguments": {
      "c2s_json": "{\"page_size\":20,\"seq_mark\":\"\",\"stock_ids\":[7000700],\"notice_types\":[0],\"extension_version\":1}",
      "api_key": "optional-per-call-api-key"
    }
  }
}

返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。

futu_get_watchlist_rating

  • Scope: qot:read
  • Python SDK 等价: —
  • 路由: MCP JSON-RPC tools/call name = "futu_get_watchlist_rating"

说明:

Get analyst reports for explicit nonempty stock IDs; never falls back to the whole market. Controlled by --extended-data-reads; default ON; live backend unverified.

请求参数:

字段 类型 必填 Alias 说明
c2s_json string ✅ — Official generated C2S JSON. Field names use generated proto serde snake_case, e.g. multi_legs / combo_legs / order_type.
api_key string? — — Optional per-call API key plaintext. HTTP scope mode still requires a valid Bearer on every /mcp request; this field overrides that identity for the tool handler. In stdio mode: tool argument > startup key.

⚠️ 未知字段: 启用 deny_unknown_fields — 任何未在表里的字段会返 unknown field error（之前静默 drop）。

JSON-RPC 调用示例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "futu_get_watchlist_rating",
    "arguments": {
      "c2s_json": "{\"page_size\":20,\"seq_mark\":\"\",\"stock_ids\":[7000700],\"extension_version\":1}",
      "api_key": "optional-per-call-api-key"
    }
  }
}

返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。

futu_get_stock_news

  • Scope: qot:read
  • Python SDK 等价: —
  • 路由: MCP JSON-RPC tools/call name = "futu_get_stock_news"

说明:

Get per-stock news with cursor, dedup-ID, and request-level tracking echo. Controlled by --extended-data-reads; default ON; live backend unverified.

请求参数:

字段 类型 必填 Alias 说明
c2s_json string ✅ — Official generated C2S JSON. Field names use generated proto serde snake_case, e.g. multi_legs / combo_legs / order_type.
api_key string? — — Optional per-call API key plaintext. HTTP scope mode still requires a valid Bearer on every /mcp request; this field overrides that identity for the tool handler. In stdio mode: tool argument > startup key.

⚠️ 未知字段: 启用 deny_unknown_fields — 任何未在表里的字段会返 unknown field error（之前静默 drop）。

JSON-RPC 调用示例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "futu_get_stock_news",
    "arguments": {
      "c2s_json": "{\"stock_id\":7000700,\"page_size\":20,\"id_type\":1,\"seq_mark\":\"\",\"dedup_ids\":[],\"extension_version\":1}",
      "api_key": "optional-per-call-api-key"
    }
  }
}

返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。

futu_get_news_translation

  • Scope: qot:read
  • Python SDK 等价: —
  • 路由: MCP JSON-RPC tools/call name = "futu_get_news_translation"

说明:

Get news translation with lossless optional fields. Controlled by --extended-data-reads; default ON; live backend unverified.

请求参数:

字段 类型 必填 Alias 说明
c2s_json string ✅ — Official generated C2S JSON. Field names use generated proto serde snake_case, e.g. multi_legs / combo_legs / order_type.
api_key string? — — Optional per-call API key plaintext. HTTP scope mode still requires a valid Bearer on every /mcp request; this field overrides that identity for the tool handler. In stdio mode: tool argument > startup key.

⚠️ 未知字段: 启用 deny_unknown_fields — 任何未在表里的字段会返 unknown field error（之前静默 drop）。

JSON-RPC 调用示例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "futu_get_news_translation",
    "arguments": {
      "c2s_json": "…",
      "api_key": "optional-per-call-api-key"
    }
  }
}

返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。

补充合同:

  • Scope: qot:read
  • API: GetNewsTranslation
  • REST: POST /api/news-translation

需 --extended-data-reads；默认启用；真实后端状态 UNVERIFIED。

字段 类型 必填 说明
c2s_json string 是 必填 news_id、is_translate、list_type、skip_image_crop 及 extension_version=1。
api_key string 否 可选调用级密钥；HTTP 仍需 Bearer 身份。

完整 C2S 字段、MCP 参数示例、返回值及精度。

futu_get_platform_announcements

  • Scope: qot:read
  • Python SDK 等价: —
  • 路由: MCP JSON-RPC tools/call name = "futu_get_platform_announcements"

说明:

平台公告全量或按页面查询；扩展数据读取默认启用，真实后端未验证。

请求参数:

字段 类型 必填 Alias 说明
c2s_json string ✅ — Official generated C2S JSON. Field names use generated proto serde snake_case, e.g. multi_legs / combo_legs / order_type.
api_key string? — — Optional per-call API key plaintext. HTTP scope mode still requires a valid Bearer on every /mcp request; this field overrides that identity for the tool handler. In stdio mode: tool argument > startup key.

⚠️ 未知字段: 启用 deny_unknown_fields — 任何未在表里的字段会返 unknown field error（之前静默 drop）。

JSON-RPC 调用示例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "futu_get_platform_announcements",
    "arguments": {
      "c2s_json": "…",
      "api_key": "optional-per-call-api-key"
    }
  }
}

返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。

补充合同:

API: GetPlatformAnnouncements

Scope: qot:read

默认启用，真机UNVERIFIED。参数与快照语义.

futu_get_platform_announcements_by_ids

  • Scope: qot:read
  • Python SDK 等价: —
  • 路由: MCP JSON-RPC tools/call name = "futu_get_platform_announcements_by_ids"

说明:

按公告ID查询；扩展数据读取默认启用，真实后端未验证。

请求参数:

字段 类型 必填 Alias 说明
c2s_json string ✅ — Official generated C2S JSON. Field names use generated proto serde snake_case, e.g. multi_legs / combo_legs / order_type.
api_key string? — — Optional per-call API key plaintext. HTTP scope mode still requires a valid Bearer on every /mcp request; this field overrides that identity for the tool handler. In stdio mode: tool argument > startup key.

⚠️ 未知字段: 启用 deny_unknown_fields — 任何未在表里的字段会返 unknown field error（之前静默 drop）。

JSON-RPC 调用示例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "futu_get_platform_announcements_by_ids",
    "arguments": {
      "c2s_json": "…",
      "api_key": "optional-per-call-api-key"
    }
  }
}

返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。

补充合同:

API: GetPlatformAnnouncementsByIds

Scope: qot:read

默认启用，真机UNVERIFIED。参数与快照语义.

futu_get_news_push_settings

  • Scope: qot:read
  • Python SDK 等价: —
  • 路由: MCP JSON-RPC tools/call name = "futu_get_news_push_settings"

说明:

资讯推送设置；设置返回独立ACK/读回状态，unknown不重发；默认启用，真实后端未验证。

请求参数:

字段 类型 必填 Alias 说明
c2s_json string ✅ — Official generated C2S JSON. Field names use generated proto serde snake_case, e.g. multi_legs / combo_legs / order_type.
api_key string? — — Optional per-call API key plaintext. HTTP scope mode still requires a valid Bearer on every /mcp request; this field overrides that identity for the tool handler. In stdio mode: tool argument > startup key.

⚠️ 未知字段: 启用 deny_unknown_fields — 任何未在表里的字段会返 unknown field error（之前静默 drop）。

JSON-RPC 调用示例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "futu_get_news_push_settings",
    "arguments": {
      "c2s_json": "…",
      "api_key": "optional-per-call-api-key"
    }
  }
}

返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。

补充合同:

API: GetNewsPushSettings

Scope: qot:read

默认启用，真机UNVERIFIED。字段、调用方身份与ACK/读回回执.

futu_set_news_push_settings

  • Scope: qot:write
  • Python SDK 等价: —
  • 路由: MCP JSON-RPC tools/call name = "futu_set_news_push_settings"

说明:

设置资讯推送；设置返回独立ACK/读回状态，unknown不重发；默认启用，真实后端未验证。

请求参数:

字段 类型 必填 Alias 说明
c2s_json string ✅ — Official generated C2S JSON. Field names use generated proto serde snake_case, e.g. multi_legs / combo_legs / order_type.
api_key string? — — Optional per-call API key plaintext. HTTP scope mode still requires a valid Bearer on every /mcp request; this field overrides that identity for the tool handler. In stdio mode: tool argument > startup key.

⚠️ 未知字段: 启用 deny_unknown_fields — 任何未在表里的字段会返 unknown field error（之前静默 drop）。

JSON-RPC 调用示例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "futu_set_news_push_settings",
    "arguments": {
      "c2s_json": "…",
      "api_key": "optional-per-call-api-key"
    }
  }
}

返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。

补充合同:

API: SetNewsPushSettings

Scope: qot:write

默认启用，真机UNVERIFIED。字段、调用方身份与ACK/读回回执.