机构 / 持仓研究¶

`futu_get_institution_list`¶

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

说明:

Get institution list. Public QOT 3418. 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_institution_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_institution_profile`¶

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

说明:

Get institution profile. Public QOT 3419. 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_institution_profile",
    "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_institution_distribution`¶

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

说明:

Get institution holding distribution. Public QOT 3420. 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_institution_distribution",
    "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_institution_holding_change`¶

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

说明:

Get institution holding change list. Public QOT 3421. 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_institution_holding_change",
    "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_institution_holding_list`¶

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

说明:

Get institution holding list. Public QOT 3422. 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_institution_holding_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_ark_fund_holding`¶

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

说明:

Get ARK fund holding data. Public QOT 3423. 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_ark_fund_holding",
    "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_ark_stock_dynamic`¶

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

说明:

Get ARK stock dynamic data. Public QOT 3424. 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_ark_stock_dynamic",
    "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_ark_active_transaction`¶

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

说明:

Get ARK active transaction data. Public QOT 3425. 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_ark_active_transaction",
    "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_institution_list¶

futu_get_institution_profile¶

futu_get_institution_distribution¶

futu_get_institution_holding_change¶

futu_get_institution_holding_list¶

futu_get_ark_fund_holding¶

futu_get_ark_stock_dynamic¶

futu_get_ark_active_transaction¶

`futu_get_institution_list`¶

`futu_get_institution_profile`¶

`futu_get_institution_distribution`¶

`futu_get_institution_holding_change`¶

`futu_get_institution_holding_list`¶

`futu_get_ark_fund_holding`¶

`futu_get_ark_stock_dynamic`¶

`futu_get_ark_active_transaction`¶