参考资料 / 衍生品¶
futu_get_rehab¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_rehab - 路由: MCP JSON-RPC
tools/callname ="futu_get_rehab"
说明:
Rehab (dividend / split / bonus) events and adjustment factors. Required for long-term K-line alignment. Python SDK: OpenQuoteContext.get_rehab.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
Security symbol in MARKET.CODE format, e.g. HK.00700, US.AAPL (alias: code / stock / security for SDK compat) |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_rehab",
"arguments": {
"symbol": "HK.00700"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_option_expiration_date¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_option_expiration_date - 路由: MCP JSON-RPC
tools/callname ="futu_get_option_expiration_date"
说明:
Option expiration-date list for an underlying (HSI / HSCEI or HK/US equity). Python SDK: OpenQuoteContext.get_option_expiration_date.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
owner_symbol |
string | ✅ | symbol, owner, code, stock |
Underlying stock symbol (HK/US equities + HSI/HSCEI only); alias: symbol / owner / code / stock |
index_option_type |
i32? | — | — | For index options only: Qot_Common::IndexOptionType (optional) |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_option_expiration_date",
"arguments": {
"owner_symbol": "HK.00700"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_option_chain¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_option_chain - 路由: MCP JSON-RPC
tools/callname ="futu_get_option_chain"
说明:
Option chain of an underlying stock within an expiry date range, grouped by strike time with call/put symbol lists. Python SDK: OpenQuoteContext.get_option_chain.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
owner_symbol |
string | ✅ | symbol, owner, code, stock |
Underlying stock symbol (e.g. HK.00700, US.AAPL); alias: symbol / owner / code / stock |
begin_time |
string | ✅ | begin, start_time, from |
Expiry range begin date yyyy-MM-dd; alias: begin / start_time / from |
end_time |
string | ✅ | end, to |
Expiry range end date yyyy-MM-dd; alias: end / to |
option_type |
string? | — | — | Option type: all|call|put (default all) |
delta_min |
float? | — | — | Optional Greek filter: only return options with delta in [min, max]; min must be <= max when both are provided. Typical ATM range: 0.3 to 0.7 for calls, -0.7 to -0.3 for puts. |
delta_max |
float? | — | — | See delta_min; must be >= delta_min when both are provided. |
iv_min |
float? | — | — | Implied volatility filter min (decimal, e.g. 0.3 = 30%); must be <= iv_max when both are provided. |
iv_max |
float? | — | — | See iv_min; must be >= iv_min when both are provided. |
oi_min |
float? | — | — | Open interest (contracts) filter min, integer; must be <= oi_max when both are provided. |
oi_max |
float? | — | — | See oi_min; must be >= oi_min when both are provided. |
gamma_min |
float? | — | — | Gamma filter min (decimal); must be <= gamma_max when both are provided. |
gamma_max |
float? | — | — | See gamma_min; must be >= gamma_min when both are provided. |
vega_min |
float? | — | — | Vega filter min (decimal); must be <= vega_max when both are provided. |
vega_max |
float? | — | — | See vega_min; must be >= vega_min when both are provided. |
theta_min |
float? | — | — | Theta filter min (decimal); must be <= theta_max when both are provided. |
theta_max |
float? | — | — | See theta_min; must be >= theta_min when both are provided. |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。运行时校验: 此 request 结构带
validate()方法 — 在 schema 之外加额外的必填字段 / 枚举取值校验。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_option_chain",
"arguments": {
"owner_symbol": "HK.00700",
"begin_time": "2026-01-01",
"end_time": "2026-12-31"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_warrant¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_warrant - 路由: MCP JSON-RPC
tools/callname ="futu_get_warrant"
说明:
List warrants on an underlying stock (or whole-market when owner_symbol omitted), sorted by volume desc. Python SDK: OpenQuoteContext.get_warrant. For advanced filtering (strike/premium/delta/etc.) use REST /api/warrant directly.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
owner_symbol |
string? | — | symbol, owner, code |
Underlying stock symbol (e.g. HK.00700); None = whole-market warrants. Alias: symbol / owner / code |
begin |
i32 | ✓ 默认 default |
offset, skip |
Pagination begin index (default 0); alias: offset / skip |
num |
i32 | ✓ 默认 default_warrant_num |
count, max_count, req_count |
Max rows (0-200, default 20); alias: count / max_count / req_count |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。运行时校验: 此 request 结构带
validate()方法 — 在 schema 之外加额外的必填字段 / 枚举取值校验。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_warrant",
"arguments": {
"owner_symbol": "HK.00700",
"begin": "2026-01-01",
"num": 20
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_owner_plate¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_owner_plate - 路由: MCP JSON-RPC
tools/callname ="futu_get_owner_plate"
说明:
List plates (industry/concept/region) that contain given stocks. Python SDK: OpenQuoteContext.get_owner_plate.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbols |
array of string | ✅ | stocks, code_list, symbol_list, security_list |
Array of security symbols in MARKET.CODE format (e.g. ["HK.00700", "US.AAPL"]). Field name is symbols (Rust native snake_case); aliases: stocks / code_list / symbol_list / security_list for SDK compat. |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_owner_plate",
"arguments": {
"symbols": [
"HK.00700"
]
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_holding_change¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_holding_change_list - 路由: MCP JSON-RPC
tools/callname ="futu_get_holding_change"
说明:
Top-holder share change list (institution / fund / executive). Python SDK: OpenQuoteContext.get_holding_change_list.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock |
Underlying stock symbol (e.g. HK.00700, US.AAPL); alias: code / stock |
holder_category |
i32 | ✅ | category |
Holder category: 1=Institution, 2=Fund, 3=Executive; alias: category |
begin_time |
string? | — | begin, start_time, from |
Begin time YYYY-MM-DD HH:MM:SS (optional); alias: begin / start_time / from |
end_time |
string? | — | end, to |
End time YYYY-MM-DD HH:MM:SS (optional); alias: end / to |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_holding_change",
"arguments": {
"symbol": "HK.00700",
"holder_category": 1,
"begin_time": "2026-01-01",
"end_time": "2026-12-31"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_future_info¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_future_info - 路由: MCP JSON-RPC
tools/callname ="futu_get_future_info"
说明:
Future contract info (contract size, last trade date, trading hours). Python SDK: OpenQuoteContext.get_future_info.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbols |
array of string | ✅ | stocks, code_list, symbol_list, security_list |
Array of future contract symbols in MARKET.CODE format (e.g. ["HK.HSImain", "US.MNQmain"]). Alias: stocks / code_list / symbol_list / security_list |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_future_info",
"arguments": {
"symbols": [
"HK.00700"
]
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_reference¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_referencestock_list - 路由: MCP JSON-RPC
tools/callname ="futu_get_reference"
说明:
Related securities of an underlying: list all warrants/futures/options derived from a given stock. Python SDK: OpenQuoteContext.get_referencestock_list.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock |
Underlying symbol (e.g. HK.00700, US.AAPL); alias: code / stock |
reference_type |
string | ✓ 默认 default_reference_type |
— | Reference type: warrant|future (default warrant). Note: option is NOT supported — use futu_get_option_chain instead. |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_reference",
"arguments": {
"symbol": "HK.00700",
"reference_type": "warrant"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_financials_earnings_price_move¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_financials_earnings_price_move - 路由: MCP JSON-RPC
tools/callname ="futu_get_financials_earnings_price_move"
说明:
Price move around financial earnings announcement dates. Futu API v10.6: OpenQuoteContext.get_financials_earnings_price_move.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
Security symbol in MARKET.CODE format, e.g. HK.00700, US.AAPL (alias: code / stock / security for SDK compat) |
period_count |
i32? | — | periodCount |
Financial period count, 1-50. Omit to use backend default 10. |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。运行时校验: 此 request 结构带
validate()方法 — 在 schema 之外加额外的必填字段 / 枚举取值校验。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_financials_earnings_price_move",
"arguments": {
"symbol": "HK.00700"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_financials_earnings_price_history¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_financials_earnings_price_history - 路由: MCP JSON-RPC
tools/callname ="futu_get_financials_earnings_price_history"
说明:
Price history around financial earnings announcement dates. Futu API v10.6: OpenQuoteContext.get_financials_earnings_price_history.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
Security symbol in MARKET.CODE format, e.g. HK.00700, US.AAPL (alias: code / stock / security for SDK compat) |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_financials_earnings_price_history",
"arguments": {
"symbol": "HK.00700"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_financials_statements¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_financials_statements - 路由: MCP JSON-RPC
tools/callname ="futu_get_financials_statements"
说明:
Financial statements. Futu API v10.6: OpenQuoteContext.get_financials_statements.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
Security symbol in MARKET.CODE format, e.g. HK.00700, US.AAPL (alias: code / stock / security for SDK compat) |
statement_type |
i32? | — | statementType |
FinancialStatementsType: 0=unknown, 1=income, 2=balance_sheet, 3=cash_flow, 4=main_index; omit to use backend default 1. Alias: statementType |
financial_type |
i32? | — | financialType |
F10Type financial period filter, supports 0-7 and 9-11; omit to use backend default 10. Alias: financialType |
currency_code |
string? | — | currencyCode |
Currency code, e.g. CNY / USD / HKD; alias: currencyCode |
next_key |
string? | — | nextKey |
Pagination key from previous response; alias: nextKey |
num |
i32? | — | — | Rows per page, 1-50. Omit to use backend default 10. |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。运行时校验: 此 request 结构带
validate()方法 — 在 schema 之外加额外的必填字段 / 枚举取值校验。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_financials_statements",
"arguments": {
"symbol": "HK.00700",
"num": 100
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_financials_revenue_breakdown¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_financials_revenue_breakdown - 路由: MCP JSON-RPC
tools/callname ="futu_get_financials_revenue_breakdown"
说明:
Financials revenue breakdown. Futu API v10.6: OpenQuoteContext.get_financials_revenue_breakdown.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
Security symbol in MARKET.CODE format, e.g. HK.00700, US.AAPL (alias: code / stock / security for SDK compat) |
date |
u32? | — | screenDate |
Screen date timestamp from screenDateList; alias: screenDate |
financial_type |
i32? | — | financialType |
F10Type financial period filter, supports 0-7 and 9; omit to use backend default 0. Alias: financialType |
currency_code |
string? | — | currencyCode |
Currency code, e.g. CNY / USD / HKD; alias: currencyCode |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。运行时校验: 此 request 结构带
validate()方法 — 在 schema 之外加额外的必填字段 / 枚举取值校验。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_financials_revenue_breakdown",
"arguments": {
"symbol": "HK.00700"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_research_analyst_consensus¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_research_analyst_consensus - 路由: MCP JSON-RPC
tools/callname ="futu_get_research_analyst_consensus"
说明:
Research analyst consensus. Futu API v10.6: OpenQuoteContext.get_research_analyst_consensus.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
Security symbol in MARKET.CODE format, e.g. HK.00700, US.AAPL (alias: code / stock / security for SDK compat) |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_research_analyst_consensus",
"arguments": {
"symbol": "HK.00700"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_research_rating_summary¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_research_rating_summary - 路由: MCP JSON-RPC
tools/callname ="futu_get_research_rating_summary"
说明:
Research rating summary/detail list. Futu API v10.6: OpenQuoteContext.get_research_rating_summary.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
Security symbol in MARKET.CODE format, e.g. US.AAPL, CA.SHOP (alias: code / stock / security for SDK compat) |
rating_dimension_type |
i32? | — | ratingDimensionType |
ResearchRatingDimensionType: 0/1=institution, 2=analyst |
uid |
string? | — | — | Institution or analyst uid; empty means summary list |
next_key |
string? | — | nextKey |
Pagination key; alias: nextKey |
num |
i32? | — | — | Page size, 1..20; omitted uses backend default 10 |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。运行时校验: 此 request 结构带
validate()方法 — 在 schema 之外加额外的必填字段 / 枚举取值校验。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_research_rating_summary",
"arguments": {
"symbol": "HK.00700",
"num": 100
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_research_morningstar_report¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_research_morningstar_report - 路由: MCP JSON-RPC
tools/callname ="futu_get_research_morningstar_report"
说明:
Morningstar research report. Futu API v10.6: OpenQuoteContext.get_research_morningstar_report.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
Security symbol in MARKET.CODE format, e.g. US.AAPL (alias: code / stock / security for SDK compat) |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_research_morningstar_report",
"arguments": {
"symbol": "HK.00700"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_valuation_detail¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_valuation_detail - 路由: MCP JSON-RPC
tools/callname ="futu_get_valuation_detail"
说明:
Valuation detail for a stock or index. Futu API v10.6: OpenQuoteContext.get_valuation_detail.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
Security symbol in MARKET.CODE format, e.g. HK.00700, US.AAPL, HK.800000 (alias: code / stock / security for SDK compat) |
valuation_type |
i32? | — | valuationType |
ValuationType: 0=recommended, 1=PE, 2=PB, 3=PS; alias: valuationType |
interval_type |
i32? | — | intervalType |
ValuationIntervalType: 0/3=1y default, 1=3m, 2=6m, 4=3y, 5=since2019, 6=5y, 7=10y, 8=2y, 9=20y, 10=30y; omit uses backend default 3. Alias: intervalType |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。运行时校验: 此 request 结构带
validate()方法 — 在 schema 之外加额外的必填字段 / 枚举取值校验。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_valuation_detail",
"arguments": {
"symbol": "HK.00700"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_valuation_plate_stock_list¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_valuation_plate_stock_list - 路由: MCP JSON-RPC
tools/callname ="futu_get_valuation_plate_stock_list"
说明:
Valuation stock list for a plate or index. Futu API v10.6: OpenQuoteContext.get_valuation_plate_stock_list.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
Plate or index symbol in MARKET.CODE format, e.g. HK.BK0001, HK.800000 (alias: code / stock / security for SDK compat) |
valuation_type |
i32? | — | valuationType |
ValuationType: 0/1=PE, 2=PB, 3=PS; alias: valuationType |
next_key |
string? | — | nextKey |
Pagination key; alias: nextKey |
num |
i32? | — | — | Page size, 1..50; omitted uses backend default 10 |
sort_type |
i32? | — | sortType |
SortType: 0/2=asc, 1=desc; omit to use backend default asc. Alias: sortType |
sort_id |
i32? | — | sortId |
SortField: 51=market_cap, 52=valuation, 53=forward, 54=percentile; alias: sortId |
filter_security |
string? | — | filterSecurity |
Optional plate filter for index components, MARKET.CODE; alias: filterSecurity |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。运行时校验: 此 request 结构带
validate()方法 — 在 schema 之外加额外的必填字段 / 枚举取值校验。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_valuation_plate_stock_list",
"arguments": {
"symbol": "HK.00700",
"num": 100
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_corporate_actions_dividends¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_corporate_actions_dividends - 路由: MCP JSON-RPC
tools/callname ="futu_get_corporate_actions_dividends"
说明:
Corporate action dividend records for securities. Futu API v10.6: OpenQuoteContext.get_corporate_actions_dividends.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
Security symbol in MARKET.CODE format, e.g. HK.00700, US.AAPL (alias: code / stock / security for SDK compat) |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_corporate_actions_dividends",
"arguments": {
"symbol": "HK.00700"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_corporate_actions_buybacks¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_corporate_actions_buybacks - 路由: MCP JSON-RPC
tools/callname ="futu_get_corporate_actions_buybacks"
说明:
Corporate action buyback records for HK/A-share securities. Futu API v10.6: OpenQuoteContext.get_corporate_actions_buybacks.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
Security symbol in MARKET.CODE format, e.g. HK.00700, US.AAPL (alias: code / stock / security for SDK compat) |
next_key |
string? | — | nextKey |
Pagination key; alias: nextKey |
num |
i32? | — | — | Page size, 1..50; omitted uses backend default 10 |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。运行时校验: 此 request 结构带
validate()方法 — 在 schema 之外加额外的必填字段 / 枚举取值校验。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_corporate_actions_buybacks",
"arguments": {
"symbol": "HK.00700",
"num": 100
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_corporate_actions_stock_splits¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_corporate_actions_stock_splits - 路由: MCP JSON-RPC
tools/callname ="futu_get_corporate_actions_stock_splits"
说明:
Corporate action stock split records for HK/US securities. Futu API v10.6: OpenQuoteContext.get_corporate_actions_stock_splits.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
Security symbol in MARKET.CODE format, e.g. HK.00700, US.AAPL (alias: code / stock / security for SDK compat) |
next_key |
string? | — | nextKey |
Pagination key; alias: nextKey |
num |
i32? | — | — | Page size, 1..50; omitted uses backend default 10 |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。运行时校验: 此 request 结构带
validate()方法 — 在 schema 之外加额外的必填字段 / 枚举取值校验。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_corporate_actions_stock_splits",
"arguments": {
"symbol": "HK.00700",
"num": 100
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_shareholders_overview¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_shareholders_overview - 路由: MCP JSON-RPC
tools/callname ="futu_get_shareholders_overview"
说明:
Shareholder ownership overview for HK/US securities. Futu API v10.6: OpenQuoteContext.get_shareholders_overview.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
HK/US security symbol in MARKET.CODE format, e.g. HK.00700 or US.AAPL (alias: code / stock / security for SDK compat) |
period_id |
i32? | — | periodId |
Optional reporting period id from holdingPeriodList; alias: periodId |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_shareholders_overview",
"arguments": {
"symbol": "HK.00700"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_shareholders_holding_changes¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_shareholders_holding_changes - 路由: MCP JSON-RPC
tools/callname ="futu_get_shareholders_holding_changes"
说明:
Shareholder holding change records for HK/US securities. Futu API v10.6: OpenQuoteContext.get_shareholders_holding_changes.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
HK/US security symbol in MARKET.CODE format, e.g. HK.00700 or US.AAPL (alias: code / stock / security for SDK compat) |
next_key |
string? | — | nextKey |
Pagination key from previous response; "-1" returns empty page |
num |
i32? | — | — | Page size, 1..50; omitted uses backend default 10 |
sort_type |
i32? | — | sortType |
Qot_Common.SortType: 0/1=desc, 2=asc; alias: sortType |
sort_column |
i32? | — | sortColumn |
Qot_Common.SortField: 62/63/64/65/66; alias: sortColumn |
filter_type |
i32? | — | filterType |
Qot_Common.HoldingChangesFilterType: 0=all,1=increase,2=decrease,3=new-in,4=close-out; alias: filterType |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。运行时校验: 此 request 结构带
validate()方法 — 在 schema 之外加额外的必填字段 / 枚举取值校验。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_shareholders_holding_changes",
"arguments": {
"symbol": "HK.00700",
"num": 100
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_shareholders_holder_detail¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_shareholders_holder_detail - 路由: MCP JSON-RPC
tools/callname ="futu_get_shareholders_holder_detail"
说明:
Shareholder holder detail records for HK/US securities. Futu API v10.6: OpenQuoteContext.get_shareholders_holder_detail.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
HK/US security symbol in MARKET.CODE format, e.g. HK.00700 or US.AAPL (alias: code / stock / security for SDK compat) |
request_type |
i32? | — | requestType |
Qot_Common.HolderDetailType: 0 default, 1..15 institution types, 100/200/300/400/500, 1000 all; alias: requestType |
next_key |
string? | — | nextKey |
Pagination key from previous response; "-1" returns empty page |
num |
i32? | — | — | Page size, 1..50; omitted uses backend default 10 |
sort_column |
i32? | — | sortColumn |
Qot_Common.SortField: 0/61=holder quantity, 62=share change num; alias: sortColumn |
sort_type |
i32? | — | sortType |
Qot_Common.SortType: 0/1=desc, 2=asc; alias: sortType |
period_id |
i32? | — | periodId |
Reporting period id from GetShareholdersOverview; alias: periodId |
holder_id |
i32? | — | holderId |
Holder id filter; alias: holderId |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。运行时校验: 此 request 结构带
validate()方法 — 在 schema 之外加额外的必填字段 / 枚举取值校验。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_shareholders_holder_detail",
"arguments": {
"symbol": "HK.00700",
"num": 100
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_shareholders_institutional¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_shareholders_institutional - 路由: MCP JSON-RPC
tools/callname ="futu_get_shareholders_institutional"
说明:
Institutional shareholder ownership statistics for HK/US securities. Futu API v10.6: OpenQuoteContext.get_shareholders_institutional.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
HK/US security symbol in MARKET.CODE format, e.g. HK.00700 or US.AAPL (alias: code / stock / security for SDK compat) |
next_key |
string? | — | nextKey |
Pagination key from previous response; "-1" returns empty page |
num |
i32? | — | — | Page size, 1..50; omitted uses backend default 10 |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。运行时校验: 此 request 结构带
validate()方法 — 在 schema 之外加额外的必填字段 / 枚举取值校验。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_shareholders_institutional",
"arguments": {
"symbol": "HK.00700",
"num": 100
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_insider_holder_list¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_insider_holder_list - 路由: MCP JSON-RPC
tools/callname ="futu_get_insider_holder_list"
说明:
Insider holder list for US securities. Futu API v10.6: OpenQuoteContext.get_insider_holder_list.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
US security symbol in MARKET.CODE format, e.g. US.AAPL (alias: code / stock / security for SDK compat) |
next_key |
string? | — | nextKey |
Pagination key from previous response; "-1" returns empty page |
num |
i32? | — | — | Page size, 1..20; omitted uses backend default 10 |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。运行时校验: 此 request 结构带
validate()方法 — 在 schema 之外加额外的必填字段 / 枚举取值校验。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_insider_holder_list",
"arguments": {
"symbol": "HK.00700",
"num": 100
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_insider_trade_list¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_insider_trade_list - 路由: MCP JSON-RPC
tools/callname ="futu_get_insider_trade_list"
说明:
Insider trade list for US securities. Futu API v10.6: OpenQuoteContext.get_insider_trade_list.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
US security symbol in MARKET.CODE format, e.g. US.AAPL (alias: code / stock / security for SDK compat) |
holder_id |
i64? | — | holderId |
Optional insider holder id filter |
next_key |
string? | — | nextKey |
Pagination key from previous response; "-1" returns empty page |
num |
i32? | — | — | Page size, 1..50; omitted uses backend default 10 |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。运行时校验: 此 request 结构带
validate()方法 — 在 schema 之外加额外的必填字段 / 枚举取值校验。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_insider_trade_list",
"arguments": {
"symbol": "HK.00700",
"num": 100
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_company_profile¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_company_profile - 路由: MCP JSON-RPC
tools/callname ="futu_get_company_profile"
说明:
Company profile labels/details for a security. Futu API v10.6: OpenQuoteContext.get_company_profile.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
Security symbol in MARKET.CODE format, e.g. HK.00700, US.AAPL (alias: code / stock / security for SDK compat) |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_company_profile",
"arguments": {
"symbol": "HK.00700"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_company_executives¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_company_executives - 路由: MCP JSON-RPC
tools/callname ="futu_get_company_executives"
说明:
Company executives / directors for a security. Futu API v10.6: OpenQuoteContext.get_company_executives.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
Security symbol in MARKET.CODE format, e.g. HK.00700, US.AAPL (alias: code / stock / security for SDK compat) |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_company_executives",
"arguments": {
"symbol": "HK.00700"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_company_executive_background¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_company_executive_background - 路由: MCP JSON-RPC
tools/callname ="futu_get_company_executive_background"
说明:
Company executive/director background for a security. Futu API v10.6: OpenQuoteContext.get_company_executive_background.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
Security symbol in MARKET.CODE format, e.g. HK.00700, US.AAPL (alias: code / stock / security for SDK compat) |
leader_name |
string | ✅ | leaderName |
Executive/director leader name from get_company_executives |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_company_executive_background",
"arguments": {
"symbol": "HK.00700",
"leader_name": "…"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_company_operational_efficiency¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_company_operational_efficiency - 路由: MCP JSON-RPC
tools/callname ="futu_get_company_operational_efficiency"
说明:
Company operational efficiency metrics such as employees and per-capita income/profit. Futu API v10.6: OpenQuoteContext.get_company_operational_efficiency.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
Security symbol in MARKET.CODE format, e.g. HK.00700, US.AAPL (alias: code / stock / security for SDK compat) |
next_key |
string? | — | nextKey |
Pagination key from previous response; alias: nextKey |
num |
i32? | — | — | Rows per page, 1-50. Omit to use backend default 10. |
currency_code |
string? | — | currencyCode |
Currency code, e.g. CNY / USD / HKD; alias: currencyCode |
financial_type |
i32? | — | financialType |
Compatibility-only field; the backend ignores financialType for company operational efficiency and always queries the fixed annual view. Alias: financialType |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。运行时校验: 此 request 结构带
validate()方法 — 在 schema 之外加额外的必填字段 / 枚举取值校验。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_company_operational_efficiency",
"arguments": {
"symbol": "HK.00700",
"num": 100
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_top_ten_buy_sell_brokers¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_top_ten_buy_sell_brokers - 路由: MCP JSON-RPC
tools/callname ="futu_get_top_ten_buy_sell_brokers"
说明:
Top ten net buy/sell brokers for HK securities. Futu API v10.6: OpenQuoteContext.get_top_ten_buy_sell_brokers.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
HK security symbol in MARKET.CODE format, e.g. HK.00700 (alias: code / stock / security for SDK compat) |
days_before |
i32? | — | daysBefore |
0 or omitted = realtime; N = previous N trading days; must be non-negative; alias: daysBefore |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。运行时校验: 此 request 结构带
validate()方法 — 在 schema 之外加额外的必填字段 / 枚举取值校验。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_top_ten_buy_sell_brokers",
"arguments": {
"symbol": "HK.00700"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_daily_short_volume¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_daily_short_volume - 路由: MCP JSON-RPC
tools/callname ="futu_get_daily_short_volume"
说明:
Daily short volume for HK/US securities. Futu API v10.6: OpenQuoteContext.get_daily_short_volume.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
Security symbol in MARKET.CODE format, e.g. HK.00700, US.AAPL (alias: code / stock / security for SDK compat) |
next_key |
string? | — | nextKey |
Pagination key; alias: nextKey |
num |
i32? | — | — | Page size, 1..50; omitted uses backend default 10 |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。运行时校验: 此 request 结构带
validate()方法 — 在 schema 之外加额外的必填字段 / 枚举取值校验。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_daily_short_volume",
"arguments": {
"symbol": "HK.00700",
"num": 100
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_short_interest¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_short_interest - 路由: MCP JSON-RPC
tools/callname ="futu_get_short_interest"
说明:
Short interest for HK/US securities. Futu API v10.6: OpenQuoteContext.get_short_interest.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, stock, security |
Security symbol in MARKET.CODE format, e.g. HK.00700, US.AAPL (alias: code / stock / security for SDK compat) |
next_key |
string? | — | nextKey |
Pagination key; alias: nextKey |
num |
i32? | — | — | Page size, 1..50; omitted uses backend default 10 |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。运行时校验: 此 request 结构带
validate()方法 — 在 schema 之外加额外的必填字段 / 枚举取值校验。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_short_interest",
"arguments": {
"symbol": "HK.00700",
"num": 100
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_option_volatility¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_option_volatility - 路由: MCP JSON-RPC
tools/callname ="futu_get_option_volatility"
说明:
Option implied-volatility analysis. Futu API v10.6: OpenQuoteContext.get_option_volatility.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, option, security |
Option symbol in MARKET.CODE format, e.g. US.AAPL260116C200000 (alias: code / option / security for SDK compat) |
query_time_period |
i32? | — | queryTimePeriod |
Query period: 0/omitted=month, 1=week, 2=month, 3=quarter, 4=half-year, 5=year |
hv_time_period |
i32? | — | hvTimePeriod |
Underlying historical-volatility period in days, 5..250; omitted uses backend default 30 |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。运行时校验: 此 request 结构带
validate()方法 — 在 schema 之外加额外的必填字段 / 枚举取值校验。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_option_volatility",
"arguments": {
"symbol": "HK.00700"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_option_exercise_probability¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_option_exercise_probability - 路由: MCP JSON-RPC
tools/callname ="futu_get_option_exercise_probability"
说明:
Option exercise probability history. Futu API v10.6: OpenQuoteContext.get_option_exercise_probability.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
symbol |
string | ✅ | code, option, security |
Option symbol in MARKET.CODE format, e.g. US.AAPL260116C200000 (alias: code / option / security for SDK compat) |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_option_exercise_probability",
"arguments": {
"symbol": "HK.00700"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_stock_screen¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.stock_screen - 路由: MCP JSON-RPC
tools/callname ="futu_stock_screen"
说明:
Stock screener. Futu API v10.6: OpenQuoteContext.stock_screen. The c2s argument is the full Qot_StockScreen C2S JSON object.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
c2s |
Value | ✅ | — | Full Qot_StockScreen C2S JSON object. Use snake_case generated proto fields, e.g. filter_list/retrieve_list/page_from/page_count. |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_stock_screen",
"arguments": {
"c2s": "…"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_option_screen¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.option_screen - 路由: MCP JSON-RPC
tools/callname ="futu_option_screen"
说明:
Option screener. Futu API v10.6: OpenQuoteContext.option_screen. The c2s argument is the full Qot_OptionScreen C2S JSON object.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
c2s |
Value | ✅ | — | Full Qot_OptionScreen C2S JSON object. Use snake_case generated proto fields, e.g. market_category_list/filter_list/sort_list/page_from/page_count. |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_option_screen",
"arguments": {
"c2s": "…"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_warrant_screen¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.warrant_screen - 路由: MCP JSON-RPC
tools/callname ="futu_warrant_screen"
说明:
Warrant screener. Futu API v10.6: OpenQuoteContext.warrant_screen. The c2s argument is the full Qot_WarrantScreen C2S JSON object.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
c2s |
Value | ✅ | — | Full Qot_WarrantScreen C2S JSON object. Use snake_case generated proto fields, e.g. market_type/filter_list/sort_list/page_from/page_count. |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_warrant_screen",
"arguments": {
"c2s": "…"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_technical_unusual¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_technical_unusual - 路由: MCP JSON-RPC
tools/callname ="futu_get_technical_unusual"
说明:
Technical indicator unusual-move summary. Futu API v10.6: OpenQuoteContext.get_technical_unusual.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
stock_symbol |
string | ✅ | symbol, code, stock, security |
Stock symbol accepted by Futu SkillWrap, e.g. HK.00700 / US.AAPL (alias: symbol / code / stock / security) |
time_range |
i32? | — | timeRange |
Time range in calendar days; omit or <=0 uses backend default 7 |
indicator_filters |
array of string | ✓ 默认 default |
indicatorFilters |
Optional technical indicator filters; omitted means all |
language_id |
i32? | — | languageId |
Language id: 0=simplified Chinese, 1=traditional, 2=English |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_technical_unusual",
"arguments": {
"stock_symbol": "…",
"indicator_filters": []
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_financial_unusual¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_financial_unusual - 路由: MCP JSON-RPC
tools/callname ="futu_get_financial_unusual"
说明:
Financial unusual-change summary. Futu API v10.6: OpenQuoteContext.get_financial_unusual.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
stock_symbol |
string | ✅ | symbol, code, stock, security |
Stock symbol accepted by Futu SkillWrap, e.g. HK.00700 / US.AAPL (alias: symbol / code / stock / security) |
time_range |
i32? | — | timeRange |
Time range in calendar days; omit or <=0 uses backend default 7 |
analysis_dimensions |
array of string | ✓ 默认 default |
analysisDimensions |
Optional financial analysis dimensions; omitted means all |
language_id |
i32? | — | languageId |
Language id: 0=simplified Chinese, 1=traditional, 2=English |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_financial_unusual",
"arguments": {
"stock_symbol": "…",
"analysis_dimensions": []
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_derivative_unusual¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_derivative_unusual - 路由: MCP JSON-RPC
tools/callname ="futu_get_derivative_unusual"
说明:
Derivative unusual-change summary. Futu API v10.6: OpenQuoteContext.get_derivative_unusual.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
stock_symbol |
string | ✅ | symbol, code, stock, security |
Stock symbol accepted by Futu SkillWrap, e.g. HK.00700 / US.AAPL (alias: symbol / code / stock / security) |
time_range |
i32? | — | timeRange |
Time range in calendar days; omit or <=0 uses backend default 7 |
analysis_dimensions |
array of string | ✓ 默认 default |
analysisDimensions |
Optional derivative analysis dimensions; omitted means all |
language_id |
i32? | — | languageId |
Language id: 0=simplified Chinese, 1=traditional, 2=English |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_derivative_unusual",
"arguments": {
"stock_symbol": "…",
"analysis_dimensions": []
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_option_quote¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_option_quote - 路由: MCP JSON-RPC
tools/callname ="futu_get_option_quote"
说明:
Get option quote data for one option leg or a combo-option leg set. Futu API v10.7: OpenQuoteContext.get_option_quote. 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_option_quote",
"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_option_strategy¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_option_strategy - 路由: MCP JSON-RPC
tools/callname ="futu_get_option_strategy"
说明:
Get option strategy candidates for an underlying security. Futu API v10.7: OpenQuoteContext.get_option_strategy. 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_option_strategy",
"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_option_strategy_analysis¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_option_strategy_analysis - 路由: MCP JSON-RPC
tools/callname ="futu_get_option_strategy_analysis"
说明:
Analyze payoff/risk metrics for a combo-option leg set. Futu API v10.7: OpenQuoteContext.get_option_strategy_analysis. 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_option_strategy_analysis",
"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_option_strategy_spread¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_option_strategy_spread - 路由: MCP JSON-RPC
tools/callname ="futu_get_option_strategy_spread"
说明:
Get available strike/expiry spread metadata for an option strategy. Futu API v10.7: OpenQuoteContext.get_option_strategy_spread. 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_option_strategy_spread",
"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_rating_change¶
- Scope:
qot:read - Python SDK 等价:
OpenQuoteContext.get_rating_change - 路由: MCP JSON-RPC
tools/callname ="futu_get_rating_change"
说明:
Get analyst rating-change data. Public QOT 3426. 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_rating_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_option_market_statistic¶
- Scope:
qot:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_option_market_statistic"
说明:
Get option market volume/open-interest statistics. Public QOT 3301.
请求参数:
| 字段 | 类型 | 必填 | 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_option_market_statistic",
"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_option_underlying_his_statistic¶
- Scope:
qot:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_option_underlying_his_statistic"
说明:
Get historical option-underlying volume/open-interest statistics. Public QOT 3302.
请求参数:
| 字段 | 类型 | 必填 | 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_option_underlying_his_statistic",
"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_option_underlying_overview¶
- Scope:
qot:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_option_underlying_overview"
说明:
Get latest batched option-underlying analytics. Public QOT 3303.
请求参数:
| 字段 | 类型 | 必填 | 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_option_underlying_overview",
"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_option_underlying_his_volatility¶
- Scope:
qot:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_option_underlying_his_volatility"
说明:
Get historical IV/HV for an option underlying. Public QOT 3304.
请求参数:
| 字段 | 类型 | 必填 | 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_option_underlying_his_volatility",
"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_option_underlying_rank¶
- Scope:
qot:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_option_underlying_rank"
说明:
Get ranked option underlyings. Public QOT 3305.
请求参数:
| 字段 | 类型 | 必填 | 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_option_underlying_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_option_rank¶
- Scope:
qot:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_option_rank"
说明:
Get ranked option contracts. Public QOT 3306.
请求参数:
| 字段 | 类型 | 必填 | 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_option_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_option_event¶
- Scope:
qot:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_option_event"
说明:
Get option unusual-activity events. Public QOT 3307.
请求参数:
| 字段 | 类型 | 必填 | 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_option_event",
"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_option_zero_dte_screener¶
- Scope:
qot:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_option_zero_dte_screener"
说明:
Screen zero-DTE option underlyings. Public QOT 3311.
请求参数:
| 字段 | 类型 | 必填 | 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_option_zero_dte_screener",
"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_option_zero_dte_contract¶
- Scope:
qot:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_option_zero_dte_contract"
说明:
Get zero-DTE option contracts for a returned chain. Public QOT 3312.
请求参数:
| 字段 | 类型 | 必填 | 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_option_zero_dte_contract",
"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_option_earnings_screener¶
- Scope:
qot:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_option_earnings_screener"
说明:
Screen option underlyings around earnings. Public QOT 3313.
请求参数:
| 字段 | 类型 | 必填 | 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_option_earnings_screener",
"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_option_seller_screener¶
- Scope:
qot:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_option_seller_screener"
说明:
Screen covered-call or cash-secured-put contracts. Public QOT 3314.
请求参数:
| 字段 | 类型 | 必填 | 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_option_seller_screener",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。