跳转至

市场排行 / 情绪

MCP 工具总览

futu_get_earnings_beat_rank

  • Scope: qot:read
  • Python SDK 等价: OpenQuoteContext.get_earnings_beat_rank
  • 路由: MCP JSON-RPC tools/call name = "futu_get_earnings_beat_rank"

说明:

Get earnings beat ranking data. Public QOT 3406. c2s_json must be generated-proto 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_get_earnings_beat_rank",
    "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_dividend_rank

  • Scope: qot:read
  • Python SDK 等价: OpenQuoteContext.get_dividend_rank
  • 路由: MCP JSON-RPC tools/call name = "futu_get_dividend_rank"

说明:

Get dividend ranking data. Public QOT 3407. c2s_json must be generated-proto 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_get_dividend_rank",
    "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_us_pre_market_rank

  • Scope: qot:read
  • Python SDK 等价: OpenQuoteContext.get_us_pre_market_rank
  • 路由: MCP JSON-RPC tools/call name = "futu_get_us_pre_market_rank"

说明:

Get US pre-market ranking data. Public QOT 3410. c2s_json must be generated-proto 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_get_us_pre_market_rank",
    "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_us_after_hours_rank

  • Scope: qot:read
  • Python SDK 等价: OpenQuoteContext.get_us_after_hours_rank
  • 路由: MCP JSON-RPC tools/call name = "futu_get_us_after_hours_rank"

说明:

Get US after-hours ranking data. Public QOT 3411. c2s_json must be generated-proto 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_get_us_after_hours_rank",
    "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_us_overnight_rank

  • Scope: qot:read
  • Python SDK 等价: OpenQuoteContext.get_us_overnight_rank
  • 路由: MCP JSON-RPC tools/call name = "futu_get_us_overnight_rank"

说明:

Get US overnight ranking data. Public QOT 3412. c2s_json must be generated-proto 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_get_us_overnight_rank",
    "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_top_movers_rank

  • Scope: qot:read
  • Python SDK 等价: OpenQuoteContext.get_top_movers_rank
  • 路由: MCP JSON-RPC tools/call name = "futu_get_top_movers_rank"

说明:

Get top movers ranking data. Public QOT 3413. c2s_json must be generated-proto 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_get_top_movers_rank",
    "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_list

  • Scope: qot:read
  • Python SDK 等价: OpenQuoteContext.get_hot_list
  • 路由: MCP JSON-RPC tools/call name = "futu_get_hot_list"

说明:

Get hot-list data. Public QOT 3414. c2s_json must be generated-proto 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_get_hot_list",
    "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_short_selling_rank

  • Scope: qot:read
  • Python SDK 等价: OpenQuoteContext.get_short_selling_rank
  • 路由: MCP JSON-RPC tools/call name = "futu_get_short_selling_rank"

说明:

Get short-selling ranking data. Public QOT 3415. c2s_json must be generated-proto 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_get_short_selling_rank",
    "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_period_change_rank

  • Scope: qot:read
  • Python SDK 等价: OpenQuoteContext.get_period_change_rank
  • 路由: MCP JSON-RPC tools/call name = "futu_get_period_change_rank"

说明:

Get period-change ranking data. Public QOT 3416. c2s_json must be generated-proto 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_get_period_change_rank",
    "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_high_dividend_soe_rank

  • Scope: qot:read
  • Python SDK 等价: OpenQuoteContext.get_high_dividend_soe_rank
  • 路由: MCP JSON-RPC tools/call name = "futu_get_high_dividend_soe_rank"

说明:

Get high-dividend SOE ranking data. Public QOT 3417. c2s_json must be generated-proto 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_get_high_dividend_soe_rank",
    "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_heat_map_data

  • Scope: qot:read
  • Python SDK 等价: OpenQuoteContext.get_heat_map_data
  • 路由: MCP JSON-RPC tools/call name = "futu_get_heat_map_data"

说明:

Get heat-map data. Public QOT 3432. c2s_json must be generated-proto 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_get_heat_map_data",
    "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_rise_fall_distribution

  • Scope: qot:read
  • Python SDK 等价: OpenQuoteContext.get_rise_fall_distribution
  • 路由: MCP JSON-RPC tools/call name = "futu_get_rise_fall_distribution"

说明:

Get rise/fall distribution. Public QOT 3433. c2s_json must be generated-proto 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_get_rise_fall_distribution",
    "arguments": {
      "c2s_json": "…",
      "api_key": "optional-per-call-api-key"
    }
  }
}

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