交易账户¶
futu_list_accounts¶
- Scope:
acc:read - Python SDK 等价:
OpenTradeContext.get_acc_list - 路由: MCP JSON-RPC
tools/callname ="futu_list_accounts"
说明:
List all trading accounts (real + simulate) visible to the gateway login.
请求参数: 无(零参数 tool)
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_list_accounts",
"arguments": {}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_funds¶
- Scope:
acc:read - Python SDK 等价:
OpenTradeContext.accinfo_query - 路由: MCP JSON-RPC
tools/callname ="futu_get_funds"
说明:
Get account funds summary (total assets, cash, market value, buying power) for a given account + market.
Cash semantics: top-level cash field is backend's summary cash in the response currency (i.e. union_currency for futures/universal, primary market currency for legacy accounts). It is NOT the sum of cash_info_list[].cash across currencies (different currencies cannot be summed without FX conversion). For per-currency breakdown, read cash_info_list. To match Futu mobile app's '现金总值 in HKD' display, client-side compute sum(cash_info_list[i].cash * fx_rate(currency[i], HKD)) — daemon does not perform FX aggregation.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
market |
string | ✅ | — | Trade market — accepts STRING (HK|US|CN|HKCC|FUTURES|SG|AU|JP|MY|CA) OR INT (1=HK, 2=US, 3=CN, 4=HKCC, 5=Futures, 6=SG, 8=AU, 15=JP, 111=MY, 112=CA per Trd_Common.TrdMarket). |
acc_id |
u64? | — | — | Trading account ID (u64). Either acc_id OR card_num is required. card_num accepts the 4-digit suffix shown in the App or the full 16-digit card number. |
card_num |
string? | — | — | App-visible card number. Accepts 4-digit suffix or 16-digit full card number. Either acc_id OR card_num is required; if both are passed, daemon validates they refer to the same account. |
env |
string | ✓ 默认 default_env |
trd_env |
Trade environment: real|simulate (default real); alias: trd_env |
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. |
currency |
string? | — | — | Optional currency for fund response unit (HKD|USD|CNH|JPY|SGD|AUD|CAD|MYR|NZD). If omitted, daemon uses the broker/account default view currency. Explicit values are validated against the account; single-market accounts may ignore explicit currency and return their base currency. |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_funds",
"arguments": {
"market": "HK",
"acc_id": 123456,
"env": "real",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_positions¶
- Scope:
acc:read - Python SDK 等价:
OpenTradeContext.position_list_query - 路由: MCP JSON-RPC
tools/callname ="futu_get_positions"
说明:
Get current positions (holdings) for an account in a given market.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
market |
string | ✅ | — | Trade market — accepts STRING (HK|US|CN|HKCC|FUTURES|SG|AU|JP|MY|CA|CRYPTO) OR INT per Trd_Common.TrdMarket. |
acc_id |
u64? | — | — | Trading account ID (u64). Either acc_id OR card_num is required. |
card_num |
string? | — | — | App-visible card number. Accepts 4-digit suffix or 16-digit full card number. |
env |
string | ✓ 默认 default_env |
trd_env |
Trade environment: real|simulate (default real); alias: trd_env |
api_key |
string? | — | — | Optional per-call API key plaintext. |
currency |
string? | — | — | Optional position view currency (HKD|USD|CNH|JPY|SGD|AUD|CAD|MYR|NZD). Crypto accounts require an explicit view currency; non-crypto accounts may ignore it. |
option_strategy_view |
boolean | ✓ 默认 default |
optionStrategyView |
Request option strategy/combo position view. Defaults to false. |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_positions",
"arguments": {
"market": "HK",
"acc_id": 123456,
"env": "real",
"api_key": "optional-per-call-api-key",
"option_strategy_view": false
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_orders¶
- Scope:
acc:read - Python SDK 等价:
OpenTradeContext.order_list_query - 路由: MCP JSON-RPC
tools/callname ="futu_get_orders"
说明:
Get today's orders (including pending / filled / cancelled) for an account in a given market.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
market |
string | ✅ | — | Trade market — accepts STRING (HK|US|CN|HKCC|FUTURES|SG|AU|JP|MY|CA) OR INT (1=HK, 2=US, 3=CN, 4=HKCC, 5=Futures, 6=SG, 8=AU, 15=JP, 111=MY, 112=CA per Trd_Common.TrdMarket). |
acc_id |
u64? | — | — | Trading account ID (u64). Either acc_id OR card_num is required. card_num accepts the 4-digit suffix shown in the App or the full 16-digit card number. |
card_num |
string? | — | — | App-visible card number. Accepts 4-digit suffix or 16-digit full card number. Either acc_id OR card_num is required; if both are passed, daemon validates they refer to the same account. |
env |
string | ✓ 默认 default_env |
trd_env |
Trade environment: real|simulate (default real); alias: trd_env |
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. |
currency |
string? | — | — | Optional currency for fund response unit (HKD|USD|CNH|JPY|SGD|AUD|CAD|MYR|NZD). If omitted, daemon uses the broker/account default view currency. Explicit values are validated against the account; single-market accounts may ignore explicit currency and return their base currency. |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_orders",
"arguments": {
"market": "HK",
"acc_id": 123456,
"env": "real",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_deals¶
- Scope:
acc:read - Python SDK 等价:
OpenTradeContext.deal_list_query - 路由: MCP JSON-RPC
tools/callname ="futu_get_deals"
说明:
Get today's deals / order fills for an account in a given market.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
market |
string | ✅ | — | Trade market — accepts STRING (HK|US|CN|HKCC|FUTURES|SG|AU|JP|MY|CA) OR INT (1=HK, 2=US, 3=CN, 4=HKCC, 5=Futures, 6=SG, 8=AU, 15=JP, 111=MY, 112=CA per Trd_Common.TrdMarket). |
acc_id |
u64? | — | — | Trading account ID (u64). Either acc_id OR card_num is required. card_num accepts the 4-digit suffix shown in the App or the full 16-digit card number. |
card_num |
string? | — | — | App-visible card number. Accepts 4-digit suffix or 16-digit full card number. Either acc_id OR card_num is required; if both are passed, daemon validates they refer to the same account. |
env |
string | ✓ 默认 default_env |
trd_env |
Trade environment: real|simulate (default real); alias: trd_env |
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. |
currency |
string? | — | — | Optional currency for fund response unit (HKD|USD|CNH|JPY|SGD|AUD|CAD|MYR|NZD). If omitted, daemon uses the broker/account default view currency. Explicit values are validated against the account; single-market accounts may ignore explicit currency and return their base currency. |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_deals",
"arguments": {
"market": "HK",
"acc_id": 123456,
"env": "real",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_margin_ratio¶
- Scope:
acc:read - Python SDK 等价:
OpenTradeContext.get_margin_ratio - 路由: MCP JSON-RPC
tools/callname ="futu_get_margin_ratio"
说明:
Query margin ratio (long/short permissions, short-pool remaining, long/short initial margin ratios) by symbol list. Python SDK: OpenTradeContext.get_margin_ratio.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
market |
string | ✅ | — | Trade market — accepts STRING (HK|US|CN|HKCC|FUTURES|SG|AU|JP|MY|CA) OR INT (1=HK, 2=US, 3=CN, 4=HKCC, 5=Futures, 6=SG, 8=AU, 15=JP, 111=MY, 112=CA per Trd_Common.TrdMarket). |
acc_id |
u64 | ✅ | — | Trading account ID (u64). ⚠️ Call futu_list_accounts first to discover — gateway does NOT infer a default; omitting or inventing an id fails. |
env |
string | ✓ 默认 default_env |
trd_env |
Trade environment: real|simulate (default real); alias: trd_env |
codes |
array of string | ✅ | symbols, code_list, symbol_list |
Symbols in MARKET.CODE format (e.g. HK.00700, US.AAPL); alias: symbols / code_list / symbol_list |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_margin_ratio",
"arguments": {
"market": "HK",
"acc_id": 123456,
"env": "real",
"codes": [
"HK.00700"
]
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_order_fee¶
- Scope:
acc:read - Python SDK 等价:
OpenTradeContext.order_fee_query - 路由: MCP JSON-RPC
tools/callname ="futu_get_order_fee"
说明:
Query order fee breakdown (commission / platform fee / stamp duty) by order_id_ex list. Python SDK: OpenTradeContext.order_fee_query.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
market |
string | ✅ | — | Trade market — accepts STRING (HK|US|CN|HKCC|FUTURES|SG|AU|JP|MY|CA) OR INT (1=HK, 2=US, 3=CN, 4=HKCC, 5=Futures, 6=SG, 8=AU, 15=JP, 111=MY, 112=CA per Trd_Common.TrdMarket). |
acc_id |
u64 | ✅ | — | Trading account ID (u64). ⚠️ Call futu_list_accounts first to discover — gateway does NOT infer a default; omitting or inventing an id fails. |
env |
string | ✓ 默认 default_env |
trd_env |
Trade environment: real|simulate (default real); alias: trd_env |
order_id_ex_list |
array of string | ✅ | order_ids_ex, order_ids |
Order_id_ex list (strings) — returned by place_order response; alias: order_ids_ex / order_ids |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_order_fee",
"arguments": {
"market": "HK",
"acc_id": 123456,
"env": "real",
"order_id_ex_list": []
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_max_trd_qtys¶
- Scope:
acc:read - Python SDK 等价:
OpenTradeContext.acctradinginfo_query - 路由: MCP JSON-RPC
tools/callname ="futu_get_max_trd_qtys"
说明:
Max buy/sell/short/buy-back qtys before placing an order. Python SDK: OpenTradeContext.acctradinginfo_query. For NORMAL (limit) orders, price is required. order_type aligns with Trd_Common.OrderType enum (1=limit, 2=market, etc).
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
market |
string | ✅ | — | Trade market — accepts STRING (HK|US|CN|HKCC|FUTURES|SG|AU|JP|MY|CA) OR INT (1=HK, 2=US, 3=CN, 4=HKCC, 5=Futures, 6=SG, 8=AU, 15=JP, 111=MY, 112=CA per Trd_Common.TrdMarket). |
acc_id |
u64 | ✅ | — | Trading account ID (u64). ⚠️ Call futu_list_accounts first to discover — gateway does NOT infer a default; omitting or inventing an id fails. |
env |
string | ✓ 默认 default_env |
trd_env |
Trade environment: real|simulate (default real); alias: trd_env |
order_type |
i32 | ✅ | — | Order type. Accepts both INTEGER (1=NORMAL/limit, 2=MARKET, 5=AUCTION, 6=ABSOLUTE_LIMIT, 7=SPECIAL_LIMIT) and STRING enum (NORMAL|MARKET|AUCTION|ABSOLUTE_LIMIT|SPECIAL_LIMIT). Example: 1 or "NORMAL". Enum double-accept: Accepts integer or OrderType enum string (NORMAL|LIMIT|MARKET|ABSOLUTE_LIMIT|AUCTION|AUCTION_LIMIT|SPECIAL_LIMIT) |
code |
string | ✅ | symbol, stock |
Security code WITHOUT market prefix (e.g. 00700 / AAPL); alias: symbol / stock |
price |
float | ✅ | — | Limit price (pass 0.0 for market orders) |
jp_acc_type |
i32? | — | jpAccType |
JP sub-account type (Trd_Common.TrdSubAccType / TrdHeader.jpAccType). Required for JP accounts unless order_id/position context supplies the sub-account. Alias: jpAccType. |
order_id |
u64? | — | — | Existing order_id (for modify-order max-qty calc, optional) |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_max_trd_qtys",
"arguments": {
"market": "HK",
"acc_id": 123456,
"env": "real",
"order_type": "NORMAL",
"code": "00700",
"price": 300.0,
"order_id": "123456789"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_history_orders¶
- Scope:
acc:read - Python SDK 等价:
OpenTradeContext.history_order_list_query - 路由: MCP JSON-RPC
tools/callname ="futu_get_history_orders"
说明:
Query historical orders (filled / cancelled) with optional time range + code filter. Python SDK: OpenTradeContext.history_order_list_query.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
market |
string | ✅ | — | Trade market — accepts STRING (HK|US|CN|HKCC|FUTURES|SG|AU|JP|MY|CA) OR INT (1=HK, 2=US, 3=CN, 4=HKCC, 5=Futures, 6=SG, 8=AU, 15=JP, 111=MY, 112=CA per Trd_Common.TrdMarket). |
acc_id |
u64 | ✅ | — | Trading account ID (u64). ⚠️ Call futu_list_accounts first to discover — gateway does NOT infer a default; omitting or inventing an id fails. |
env |
string | ✓ 默认 default_env |
trd_env |
Trade environment: real|simulate (default real); alias: trd_env |
code_list |
array of string | ✓ 默认 default |
symbols, symbol_list |
Filter by codes (empty = all). Each item is bare code without market prefix. Alias: symbols / symbol_list |
begin_time |
string? | — | begin, start_time, from |
Begin time 'yyyy-MM-dd HH |
end_time |
string? | — | end, to |
End time 'yyyy-MM-dd HH |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_history_orders",
"arguments": {
"market": "HK",
"acc_id": 123456,
"env": "real",
"code_list": [
"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_history_deals¶
- Scope:
acc:read - Python SDK 等价:
OpenTradeContext.history_deal_list_query - 路由: MCP JSON-RPC
tools/callname ="futu_get_history_deals"
说明:
Query historical deals / fills with optional time range + code filter. Python SDK: OpenTradeContext.history_deal_list_query.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
market |
string | ✅ | — | Trade market — accepts STRING (HK|US|CN|HKCC|FUTURES|SG|AU|JP|MY|CA) OR INT (1=HK, 2=US, 3=CN, 4=HKCC, 5=Futures, 6=SG, 8=AU, 15=JP, 111=MY, 112=CA per Trd_Common.TrdMarket). |
acc_id |
u64 | ✅ | — | Trading account ID (u64). ⚠️ Call futu_list_accounts first to discover — gateway does NOT infer a default; omitting or inventing an id fails. |
env |
string | ✓ 默认 default_env |
trd_env |
Trade environment: real|simulate (default real); alias: trd_env |
code_list |
array of string | ✓ 默认 default |
symbols, symbol_list |
Filter by codes (empty = all). Each item is bare code without market prefix. Alias: symbols / symbol_list |
begin_time |
string? | — | begin, start_time, from |
Begin time 'yyyy-MM-dd HH |
end_time |
string? | — | end, to |
End time 'yyyy-MM-dd HH |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_history_deals",
"arguments": {
"market": "HK",
"acc_id": 123456,
"env": "real",
"code_list": [
"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_flow_summary¶
- Scope:
acc:read - Python SDK 等价:
OpenTradeContext.acc_cash_flow_query (summary variant) - 路由: MCP JSON-RPC
tools/callname ="futu_get_flow_summary"
说明:
Alias of futu_get_acc_cash_flow (MCP-REST naming symmetry with /api/flow-summary). Account cash-flow statement for a clearing date. Python SDK: OpenTradeContext.get_acc_cash_flow.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
env |
string | ✓ 默认 default_env |
trd_env |
Trade env: real / simulate (default real); alias: trd_env |
acc_id |
u64 | ✅ | — | Trading account ID (u64). ⚠️ Call futu_list_accounts first to discover — gateway does NOT infer a default. |
market |
string | ✅ | — | Trade market — accepts STRING (HK / US / CN / HKCC / SG / AU / JP / MY / CA) OR INT (1=HK, 2=US, 3=CN, 4=HKCC, 6=SG, 8=AU, 15=JP, 111=MY, 112=CA per Trd_Common.TrdMarket). |
clearing_date |
string | ✅ | date, query_date |
Clearing date (yyyy-MM-dd); queries flow entries for that day; alias: date / query_date |
direction |
i32? | — | flow_direction |
Direction: 1=InFlow, 2=OutFlow, omit for both; alias: flow_direction |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_flow_summary",
"arguments": {
"env": "real",
"acc_id": 123456,
"market": "HK",
"clearing_date": "2026-04-20",
"direction": 1
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_cash_log¶
- Scope:
acc:read - Python SDK 等价:
OpenTradeContext.cash_flow_query - 路由: MCP JSON-RPC
tools/callname ="futu_get_cash_log"
说明:
Fetch detailed account cash log entries with richer filters than futu_get_acc_cash_flow. Native time range, business group / currency / keyword / symbol / direction filters, cursor-based pagination. When max_cnt is omitted the daemon uses the mobile default of 50.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
env |
string | ✓ 默认 default_env |
trd_env |
Trade env: real / simulate (default real) |
acc_id |
u64 | ✅ | — | Trading account ID (u64). Call futu_list_accounts first. |
market |
string? | — | — | Optional legacy market hint. Accepted for backward compatibility (HK/US/CN/HKCC/FUTURES/SG/CRYPTO/AU/JP/MY/CA/HKFUND/USFUND/SGFUND/MYFUND/JPFUND or ½/¾/⅚/⅞/15/111/112/113/123/124/125/126), but cash-log identity does not trust this field: daemon derives backend market from acc_id/account cache. |
begin_time |
u64? | — | — | Begin time (epoch seconds, optional) |
end_time |
u64? | — | — | End time (epoch seconds, optional) |
biz_group_id |
u32? | — | — | Business group ID filter (default all) |
biz_sub_group_id |
u32? | — | — | Business sub-group ID filter (optional; value from futu_get_biz_group sub_groups) |
in_out |
u32? | — | — | In/out direction: 1=in, 2=out, 0/omit=all |
keyword |
string? | — | — | Search keyword (optional) |
symbol |
string? | — | — | Stock symbol (e.g. AAPL.US, 00700.HK), exact match (optional) |
stock_id |
u64? | — | — | Backend stock_id filter (optional; use when available from upstream/account UI data) |
log_id |
string? | — | — | Cursor: log_id from previous response next_log_id (omit for first page) |
max_cnt |
u32? | — | — | Max entries per response (daemon uses mobile default 50 if omit) |
currency |
string? | — | — | Currency filter: CNY/HKD/USD/JPY/SGD (optional) |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_cash_log",
"arguments": {
"env": "real",
"acc_id": 123456,
"market": "HK",
"begin_time": "2026-01-01",
"end_time": "2026-12-31",
"symbol": "HK.00700"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_cash_detail¶
- Scope:
acc:read - Python SDK 等价:
OpenTradeContext.cash_flow_query (detail variant) - 路由: MCP JSON-RPC
tools/callname ="futu_get_cash_detail"
说明:
Fetch a single cash log entry detail. Use after futu_get_cash_log; log_id comes from monthly_logs[].entries[].log_id.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
env |
string | ✓ 默认 default_env |
trd_env |
Trade env: real / simulate (default real) |
acc_id |
u64 | ✅ | — | Trading account ID (u64) |
market |
string? | — | — | Optional legacy market hint; accepted for backward compatibility but ignored. Daemon derives backend market from acc_id/account cache. |
log_id |
string | ✅ | — | Cash log ID (from futu_get_cash_log response) |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_cash_detail",
"arguments": {
"env": "real",
"acc_id": 123456,
"market": "HK",
"log_id": "…"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_biz_group¶
- Scope:
acc:read - Python SDK 等价:
OpenTradeContext.get_biz_group - 路由: MCP JSON-RPC
tools/callname ="futu_get_biz_group"
说明:
Fetch cash log business group, currency, and direction metadata for client UI filters. Returns biz_groups with sub_groups, currencies, and directions.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
env |
string | ✓ 默认 default_env |
trd_env |
Trade env: real / simulate (default real) |
acc_id |
u64 | ✅ | — | Trading account ID (u64) |
market |
string? | — | — | Optional legacy market hint; accepted for backward compatibility but ignored. Daemon derives backend market from acc_id/account cache. |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_biz_group",
"arguments": {
"env": "real",
"acc_id": 123456,
"market": "HK"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_margin_info¶
- Scope:
acc:read - Python SDK 等价:
OpenTradeContext.get_margin_info - 路由: MCP JSON-RPC
tools/callname ="futu_get_margin_info"
说明:
Per-account margin info: buying power, leverage, risk status, liquidity, HK margin fields, and mobile risk metadata. Supports HK / US / CN_AH markets (mobile cmd 3101/3102/3107). Complements futu_get_margin_ratio, which is per-security.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
env |
string | ✓ 默认 default_env |
trd_env |
Trade env: real / simulate (default real) |
acc_id |
u64 | ✅ | — | Trading account ID (u64). Call futu_list_accounts first. |
market |
string | ✅ | — | Market: HK / US / CN_AH (only these 3 supported; mobile cmd 3101/3102/3107). Other markets: use futu_get_margin_ratio (per-security ratio). |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_margin_info",
"arguments": {
"env": "real",
"acc_id": 123456,
"market": "HK"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_account_flag¶
- Scope:
acc:read - Python SDK 等价:
OpenTradeContext.get_account_flag - 路由: MCP JSON-RPC
tools/callname ="futu_get_account_flag"
说明:
Query account compliance flag (product access, risk disclosure, opt-in status). Common flag_id values: 5=US options, 22=derivatives disclosure, 10=fund KYC R1-R5, 16=PDT, 23=US OTC, 11=HK options. The response includes item_present and flag_value_present so clients can distinguish a missing flag record from an explicit flag_value=0.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
env |
string | ✓ 默认 default_env |
trd_env |
Trade env: real / simulate (default real) |
acc_id |
u64 | ✅ | — | Trading account ID (u64) for per-broker routing |
flag_id |
u32 | ✅ | — | Flag ID to query. Common: 5=US 期权确认, 8=期权测评, 10=基金 KYC (R1~R5), 11=HK 期权确认, 16=PDT 风披, 22=衍生品风批 (合并新), 23=美股 OTC, 24=港股期权测评, 25=算法交易风披, 34=人脸识别风批, 46=OpenAPI 免责. Full 36+ list in proto header. |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_account_flag",
"arguments": {
"env": "real",
"acc_id": 123456,
"flag_id": 0
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_bond_total_asset¶
- Scope:
acc:read - Python SDK 等价:
OpenTradeContext.get_bond_total_asset - 路由: MCP JSON-RPC
tools/callname ="futu_get_bond_total_asset"
说明:
Bond account total asset and P&L summary for HK/US/SG bond accounts. Returns total_asset, position_incomes, today_incomes, accrued_interest, and ccy.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
env |
string | ✓ 默认 default_env |
trd_env |
Trade env: real / simulate (default real) |
acc_id |
u64 | ✅ | — | Trading account ID (u64) for per-broker routing |
market |
string | ✅ | — | Market: HK / US / SG; aliases USA and SG_UNIVERSAL are accepted |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_bond_total_asset",
"arguments": {
"env": "real",
"acc_id": 123456,
"market": "HK"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_bond_single_asset¶
- Scope:
acc:read - Python SDK 等价:
OpenTradeContext.get_bond_single_asset - 路由: MCP JSON-RPC
tools/callname ="futu_get_bond_single_asset"
说明:
Single bond position for HK/US/SG bond accounts, including market value, quantity, cost, expiry, dividend schedule, accrued interest, legacy notice fields, notice_list, currency, and price.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
env |
string | ✓ 默认 default_env |
trd_env |
Trade env: real / simulate (default real) |
acc_id |
u64 | ✅ | — | Trading account ID (u64) for per-broker routing |
market |
string | ✅ | — | Market: HK / US / SG; aliases USA and SG_UNIVERSAL are accepted |
symbol |
string | ✅ | — | Bond symbol (债券代码, 如 HK1234 或 11000018) |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_bond_single_asset",
"arguments": {
"env": "real",
"acc_id": 123456,
"market": "HK",
"symbol": "HK.00700"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_bond_position_list¶
- Scope:
acc:read - Python SDK 等价:
OpenTradeContext.get_bond_position_list - 路由: MCP JSON-RPC
tools/callname ="futu_get_bond_position_list"
说明:
Bond account position list for HK/US/SG bond accounts. Returns total and bond_list items with name, symbol, market value, quantity, price, cost, incomes, accrued interest, notice, call flag, and ccy.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
env |
string | ✓ 默认 default_env |
trd_env |
Trade env: real / simulate (default real) |
acc_id |
u64 | ✅ | — | Trading account ID (u64) for per-broker routing |
market |
string | ✅ | — | Market: HK / US / SG; aliases USA and SG_UNIVERSAL are accepted |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_bond_position_list",
"arguments": {
"env": "real",
"acc_id": 123456,
"market": "HK"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_bond_answer_state¶
- Scope:
acc:read - Python SDK 等价:
OpenTradeContext.get_bond_answer_state - 路由: MCP JSON-RPC
tools/callname ="futu_get_bond_answer_state"
说明:
Query whether the user needs to answer a suitability questionnaire before bond trading. Returns need_to_answer plus notice fields such as title, content, and confirm_url.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
env |
string | ✓ 默认 default_env |
trd_env |
Trade env: real / simulate (default real) |
acc_id |
u64 | ✅ | — | Trading account ID (u64) for per-broker routing |
market |
string | ✅ | — | Market: HK / US / SG; aliases USA and SG_UNIVERSAL are accepted |
symbol |
string | ✅ | — | Bond symbol (债券代码, 如 HK1234 或 11000018) |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_bond_answer_state",
"arguments": {
"env": "real",
"acc_id": 123456,
"market": "HK",
"symbol": "HK.00700"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_bond_trade_reminder¶
- Scope:
acc:read - Python SDK 等价:
OpenTradeContext.get_bond_trade_reminder - 路由: MCP JSON-RPC
tools/callname ="futu_get_bond_trade_reminder"
说明:
Bond trade reminders for buy/sell availability, complex product, high risk, and pre-qualification. Returns ReminderItem fields for tradeable, complex_product, high_risk, sell_tradeable, and pre_qualification.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
env |
string | ✓ 默认 default_env |
trd_env |
Trade env: real / simulate (default real) |
acc_id |
u64 | ✅ | — | Trading account ID (u64) for per-broker routing |
market |
string | ✅ | — | Market: HK / US / SG; aliases USA and SG_UNIVERSAL are accepted |
symbol |
string | ✅ | — | Bond symbol (债券代码, 如 HK1234 或 11000018) |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_bond_trade_reminder",
"arguments": {
"env": "real",
"acc_id": 123456,
"market": "HK",
"symbol": "HK.00700"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_token_state¶
- Scope:
acc:read - Python SDK 等价:
— (gateway local token diagnostics) - 路由: MCP JSON-RPC
tools/callname ="futu_get_token_state"
说明:
Query Futu Token / moomoo Token enable + bind state. Returns 4 fields: nn_token_enable, nn_token_bind, mm_token_enable, mm_token_bind (1=enabled/bound, 0=disabled/unbound). Use case: when /api/unlock-trade fails with -20011 ("please enable Futu Token"), call this tool first to diagnose which side is missing token binding.
请求参数: 无(零参数 tool)
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_token_state",
"arguments": {}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_acc_cash_flow¶
- Scope:
acc:read - Python SDK 等价:
OpenTradeContext.acc_cash_flow_query - 路由: MCP JSON-RPC
tools/callname ="futu_get_acc_cash_flow"
说明:
Account cash-flow statement for a clearing date. Python SDK: OpenTradeContext.get_acc_cash_flow.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
env |
string | ✓ 默认 default_env |
trd_env |
Trade env: real / simulate (default real); alias: trd_env |
acc_id |
u64 | ✅ | — | Trading account ID (u64). ⚠️ Call futu_list_accounts first to discover — gateway does NOT infer a default. |
market |
string | ✅ | — | Trade market — accepts STRING (HK / US / CN / HKCC / SG / AU / JP / MY / CA) OR INT (1=HK, 2=US, 3=CN, 4=HKCC, 6=SG, 8=AU, 15=JP, 111=MY, 112=CA per Trd_Common.TrdMarket). |
clearing_date |
string | ✅ | date, query_date |
Clearing date (yyyy-MM-dd); queries flow entries for that day; alias: date / query_date |
direction |
i32? | — | flow_direction |
Direction: 1=InFlow, 2=OutFlow, omit for both; alias: flow_direction |
⚠️ 未知字段: 启用
deny_unknown_fields— 任何未在表里的字段会返unknown fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_acc_cash_flow",
"arguments": {
"env": "real",
"acc_id": 123456,
"market": "HK",
"clearing_date": "2026-04-20",
"direction": 1
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_get_combo_max_trd_qtys¶
- Scope:
acc:read - Python SDK 等价:
OpenSecTradeContext.get_combo_max_trd_qtys - 路由: MCP JSON-RPC
tools/callname ="futu_get_combo_max_trd_qtys"
说明:
Get maximum trade quantity for a combo-option order. Futu API v10.7: OpenSecTradeContext.get_combo_max_trd_qtys. c2s_json must include header.acc_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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_combo_max_trd_qtys",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_preview_order_impact¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_preview_order_impact"
说明:
Preview fee, margin and risk sidecars before placing a typed single, modify, combo or crypto order. Estimate only; local extension v1.
请求参数:
| 字段 | 类型 | 必填 | 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_preview_order_impact",
"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_asset_trend¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_asset_trend"
说明:
Get the server-calculated customer and broker-area asset timeline. Local extension v1; controlled by --extended-data-reads, enabled by default.
请求参数:
| 字段 | 类型 | 必填 | 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_asset_trend",
"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_yield_trend¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_yield_trend"
说明:
Get the server-calculated customer and broker-area yield timeline and benchmark comparisons. Local extension v1.
请求参数:
| 字段 | 类型 | 必填 | 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_yield_trend",
"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_return_calendar¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_return_calendar"
说明:
Get the server-calculated customer and broker-area monthly or yearly return calendar. Local extension v1.
请求参数:
| 字段 | 类型 | 必填 | 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_return_calendar",
"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_order_relations¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_order_relations"
说明:
Read a complete cached order relation graph by order or group id. Returns explicit not-available or stale status and never contacts a backend.
请求参数:
| 字段 | 类型 | 必填 | 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_order_relations",
"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_position_corporate_actions¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_position_corporate_actions"
说明:
Read position-related stock and option-underlying corporate-action risk from a fresh account position snapshot. 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_position_corporate_actions",
"arguments": {
"c2s_json": "{\"header\":{\"trd_env\":1,\"acc_id\":900000001,\"trd_market\":2},\"extension_version\":1}",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
futu_algo_order_logs¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_algo_order_logs"
说明:
Query algorithm parent/child execution reports with zero-based pagination or fetch_all. Controlled by --extended-data-reads.
请求参数:
| 字段 | 类型 | 必填 | 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_algo_order_logs",
"arguments": {
"c2s_json": "{\"header\":{\"trd_env\":1,\"acc_id\":900000001,\"trd_market\":2},\"algo_order_id\":\"server-algo-order-id\",\"page_index\":0,\"page_size\":50,\"fetch_all\":false,\"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_order_fill_details¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_order_fill_details"
说明:
Read 订单分笔成交 for the selected account. 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_order_fill_details",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
API: GetOrderFillDetails
Scope: acc:read
使用 --extended-data-reads(默认启用)。真机状态 UNVERIFIED。必填 c2s_json 传 C2S JSON 字符串;api_key 为可选调用密钥。请求字段与返回值合同.
futu_get_order_dates¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_order_dates"
说明:
Read 历史订单日期 for the selected account. 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_order_dates",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
API: GetOrderDates
Scope: acc:read
使用 --extended-data-reads(默认启用)。真机状态 UNVERIFIED。必填 c2s_json 传 C2S JSON 字符串;api_key 为可选调用密钥。请求字段与返回值合同.
futu_get_today_fill_statistics¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_today_fill_statistics"
说明:
Read 今日成交统计 for the selected account. 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_today_fill_statistics",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
API: GetTodayFillStatistics
Scope: acc:read
使用 --extended-data-reads(默认启用)。真机状态 UNVERIFIED。必填 c2s_json 传 C2S JSON 字符串;api_key 为可选调用密钥。请求字段与返回值合同.
futu_get_future_subpositions¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_future_subpositions"
说明:
Read 期货子持仓 for the selected account. 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_future_subpositions",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
API: GetFutureSubpositions
Scope: acc:read
使用 --extended-data-reads(默认启用)。真机状态 UNVERIFIED。必填 c2s_json 传 C2S JSON 字符串;api_key 为可选调用密钥。请求字段与返回值合同.
futu_get_symbol_history_orders¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_symbol_history_orders"
说明:
Read 按标的历史订单 for the selected account. 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_symbol_history_orders",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
API: GetSymbolHistoryOrders
Scope: acc:read
使用 --extended-data-reads(默认启用)。真机状态 UNVERIFIED。必填 c2s_json 传 C2S JSON 字符串;api_key 为可选调用密钥。请求字段与返回值合同.
futu_get_symbol_history_fills¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_symbol_history_fills"
说明:
Read 按标的历史成交 for the selected account. 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_symbol_history_fills",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
API: GetSymbolHistoryFills
Scope: acc:read
使用 --extended-data-reads(默认启用)。真机状态 UNVERIFIED。必填 c2s_json 传 C2S JSON 字符串;api_key 为可选调用密钥。请求字段与返回值合同.
futu_get_sub_account_fill_quantities¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_sub_account_fill_quantities"
说明:
Read 子账户成交拆分 for the selected account. 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_sub_account_fill_quantities",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
API: GetSubAccountFillQuantities
Scope: acc:read
使用 --extended-data-reads(默认启用)。真机状态 UNVERIFIED。必填 c2s_json 传 C2S JSON 字符串;api_key 为可选调用密钥。请求字段与返回值合同.
futu_get_symbol_trade_counts¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_symbol_trade_counts"
说明:
Read 标的周期成交统计 for the selected account. 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_symbol_trade_counts",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
API: GetSymbolTradeCounts
Scope: acc:read
使用 --extended-data-reads(默认启用)。真机状态 UNVERIFIED。必填 c2s_json 传 C2S JSON 字符串;api_key 为可选调用密钥。请求字段与返回值合同.
futu_get_future_position_breakdown¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_future_position_breakdown"
说明:
Read 期货持仓明细视图 for the selected account. 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_future_position_breakdown",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
API: GetFuturePositionBreakdown
Scope: acc:read
使用 --extended-data-reads(默认启用)。真机状态 UNVERIFIED。必填 c2s_json 传 C2S JSON 字符串;api_key 为可选调用密钥。请求字段与返回值合同.
futu_get_option_combo_eligibility¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_option_combo_eligibility"
说明:
期权组合账户资格。扩展数据读取默认启用;真实后端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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_option_combo_eligibility",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
API: GetOptionComboEligibility
Scope: acc:read
使用 --extended-data-reads(默认启用),真机 UNVERIFIED。必填 c2s_json 字符串,可选 api_key。字段、返回值与授权边界.
futu_get_broker_option_strategies¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_broker_option_strategies"
说明:
券商期权策略配置。扩展数据读取默认启用;真实后端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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_broker_option_strategies",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
API: GetBrokerOptionStrategies
Scope: acc:read
使用 --extended-data-reads(默认启用),真机 UNVERIFIED。必填 c2s_json 字符串,可选 api_key。字段、返回值与授权边界.
futu_get_transaction_fee_plan¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_transaction_fee_plan"
说明:
账户费率方案。扩展数据读取默认启用;真实后端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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_transaction_fee_plan",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
API: GetTransactionFeePlan
Scope: acc:read
使用 --extended-data-reads(默认启用),真机 UNVERIFIED。必填 c2s_json 字符串,可选 api_key。字段、返回值与授权边界.
futu_get_legacy_future_fee_config¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_legacy_future_fee_config"
说明:
历史期货费用配置。扩展数据读取默认启用;真实后端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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_legacy_future_fee_config",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
API: GetLegacyFutureFeeConfig
Scope: acc:read
使用 --extended-data-reads(默认启用),真机 UNVERIFIED。必填 c2s_json 字符串,可选 api_key。字段、返回值与授权边界.
futu_get_premium_entitlements¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_premium_entitlements"
说明:
Premium权益。扩展数据读取默认启用;真实后端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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_premium_entitlements",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
API: GetPremiumEntitlements
Scope: acc:read
使用 --extended-data-reads(默认启用),真机 UNVERIFIED。必填 c2s_json 字符串,可选 api_key。字段、返回值与授权边界.
futu_get_fractional_share_whitelist¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_fractional_share_whitelist"
说明:
碎股白名单。扩展数据读取默认启用;真实后端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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_fractional_share_whitelist",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
API: GetFractionalShareWhitelist
Scope: acc:read
使用 --extended-data-reads(默认启用),真机 UNVERIFIED。必填 c2s_json 字符串,可选 api_key。字段、返回值与授权边界.
futu_get_broker_total_assets¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_broker_total_assets"
说明:
券商总资产。扩展数据读取默认启用;真实后端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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_broker_total_assets",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
API: GetBrokerTotalAssets
Scope: acc:read
使用 --extended-data-reads(默认启用),真机 UNVERIFIED。必填 c2s_json 字符串,可选 api_key。字段、返回值与授权边界.
futu_get_trade_password_state¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_trade_password_state"
说明:
交易密码存在状态。扩展数据读取默认启用;真实后端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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_trade_password_state",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
API: GetTradePasswordState
Scope: acc:read
使用 --extended-data-reads(默认启用),真机 UNVERIFIED。必填 c2s_json 字符串,可选 api_key。字段、返回值与授权边界.
futu_get_cash_sweep_configuration¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_cash_sweep_configuration"
说明:
闲钱配置;只读,保留缺省与原始值,默认启用,真实后端未验证。
请求参数:
| 字段 | 类型 | 必填 | 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_cash_sweep_configuration",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
API: GetCashSweepConfiguration
Scope: acc:read
Contract / 字段与权限. Default ON; live UNVERIFIED.
futu_get_cash_sweep_redemption_capacity¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_cash_sweep_redemption_capacity"
说明:
闲钱赎回额度;只读,保留缺省与原始值,默认启用,真实后端未验证。
请求参数:
| 字段 | 类型 | 必填 | 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_cash_sweep_redemption_capacity",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
API: GetCashSweepRedemptionCapacity
Scope: acc:read
Contract / 字段与权限. Default ON; live UNVERIFIED.
futu_get_wealth_holdings¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_wealth_holdings"
说明:
Account wealth positions. Enabled by default; live backend unverified. Does not buy, redeem or transfer assets.
请求参数:
| 字段 | 类型 | 必填 | 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_wealth_holdings",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
权限:acc:read。财富读取合同。默认启用,真实后端尚未验证。使用指定账户;基金详情要求已认证且不受账户集合限制的调用方。
futu_get_bond_account_positions¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_bond_account_positions"
说明:
Account wealth positions. Enabled by default; live backend unverified. Does not buy, redeem or transfer assets.
请求参数:
| 字段 | 类型 | 必填 | 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_bond_account_positions",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
权限:acc:read。财富读取合同。默认启用,真实后端尚未验证。使用指定账户;基金详情要求已认证且不受账户集合限制的调用方。
futu_get_fund_account_positions¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_fund_account_positions"
说明:
Account wealth positions. Enabled by default; live backend unverified. Does not buy, redeem or transfer assets.
请求参数:
| 字段 | 类型 | 必填 | 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_fund_account_positions",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
权限:acc:read。财富读取合同。默认启用,真实后端尚未验证。使用指定账户;基金详情要求已认证且不受账户集合限制的调用方。
futu_get_fund_position_details¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_fund_position_details"
说明:
Account wealth positions. Enabled by default; live backend unverified. Does not buy, redeem or transfer assets.
请求参数:
| 字段 | 类型 | 必填 | 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_fund_position_details",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
权限:acc:read。财富读取合同。默认启用,真实后端尚未验证。使用指定账户;基金详情要求已认证且不受账户集合限制的调用方。
futu_get_forex_accounts¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_forex_accounts"
说明:
Read source-owned Forex account data. Requires acc:read and FX when market-limited. Enabled by default; live backend unverified. No trading or transfers.
请求参数:
| 字段 | 类型 | 必填 | 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_forex_accounts",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
Scope: acc:read; a nonempty market allowlist must contain FX. Forex read contract. Default ON; live backend UNVERIFIED.
futu_get_forex_risk_control¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_forex_risk_control"
说明:
Read source-owned Forex account data. Requires acc:read and FX when market-limited. Enabled by default; live backend unverified. No trading or transfers.
请求参数:
| 字段 | 类型 | 必填 | 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_forex_risk_control",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
Scope: acc:read; a nonempty market allowlist must contain FX. Forex read contract. Default ON; live backend UNVERIFIED.
futu_preview_forex_margin¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_preview_forex_margin"
说明:
Read source-owned Forex account data. Requires acc:read and FX when market-limited. Enabled by default; live backend unverified. No trading or transfers.
请求参数:
| 字段 | 类型 | 必填 | 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_preview_forex_margin",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
Scope: acc:read; a nonempty market allowlist must contain FX. Forex read contract. Default ON; live backend UNVERIFIED.
futu_get_forex_assets¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_forex_assets"
说明:
Read source-owned Forex account data. Requires acc:read and FX when market-limited. Enabled by default; live backend unverified. No trading or transfers.
请求参数:
| 字段 | 类型 | 必填 | 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_forex_assets",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
权限:acc:read;非空市场限制须包含 FX。外汇读取合同。默认启用,真实后端尚未验证。通过 c2s_json 显式传入账户、币种及六个布尔选项,保留当前调用者身份。
futu_get_forex_account_quote_context¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_forex_account_quote_context"
说明:
Read source-owned Forex account data. Requires acc:read and FX when market-limited. Enabled by default; live backend unverified. No trading or transfers.
请求参数:
| 字段 | 类型 | 必填 | 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_forex_account_quote_context",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
权限:acc:read;非空市场限制须包含 FX。外汇读取合同。默认启用,真实后端尚未验证。原始上下文不构成订阅资格。
futu_get_forex_symbol_configs¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_forex_symbol_configs"
说明:
Read source-owned Forex account data. Requires acc:read and FX when market-limited. Enabled by default; live backend unverified. No trading or transfers.
请求参数:
| 字段 | 类型 | 必填 | 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_forex_symbol_configs",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
权限:acc:read;非空市场限制须包含 FX。外汇读取合同。默认启用,真实后端尚未验证。只读取券商品种设置,不发现账户或授予交易资格。
futu_get_forex_unlock_status¶
- Scope:
trade:unlock - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_forex_unlock_status"
说明:
Read safe historical attempts and current local Forex credential status. Requires trade:unlock and FX/target access; no network request or credential recovery.
请求参数:
| 字段 | 类型 | 必填 | Alias | 说明 |
|---|---|---|---|---|
c2s_json |
string | ✅ | — | — |
api_key |
string? | — | — | — |
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_forex_unlock_status",
"arguments": {
"c2s_json": "…"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
权限:trade:unlock;市场及账户限制须允许 FX 和每个目标。通过 c2s_json 传入显式请求,见 Forex 解锁合同。网络认证默认启用,本地清锁/状态不依赖网络开关。真实后端尚未验证。
futu_get_account_financing_setting¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_account_financing_setting"
说明:
Read account funding rules for currently authorized real accounts. Settings writes require acc:read and trade:real with explicit intent; no transfer is performed. Reads are enabled by default; settings writes retain their independent opt-in. Live backend behavior is 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_account_financing_setting",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
权限:acc:read。通过 c2s_json 传入显式请求,按当前账户及市场权限校验。详见融资与自动换汇设置。默认启用,设置需独立启用;真实后端尚未验证。
futu_get_account_auto_exchange_setting¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_account_auto_exchange_setting"
说明:
Read account funding rules for currently authorized real accounts. Settings writes require acc:read and trade:real with explicit intent; no transfer is performed. Reads are enabled by default; settings writes retain their independent opt-in. Live backend behavior is 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_account_auto_exchange_setting",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
权限:acc:read。通过 c2s_json 传入显式请求,按当前账户及市场权限校验。详见融资与自动换汇设置。默认启用,设置需独立启用;真实后端尚未验证。
futu_get_account_foreign_exchange_setting¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_account_foreign_exchange_setting"
说明:
Read account funding rules for currently authorized real accounts. Settings writes require acc:read and trade:real with explicit intent; no transfer is performed. Reads are enabled by default; settings writes retain their independent opt-in. Live backend behavior is 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_account_foreign_exchange_setting",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
权限:acc:read。通过 c2s_json 传入显式请求,按当前账户及市场权限校验。详见融资与自动换汇设置。默认启用,设置需独立启用;真实后端尚未验证。
futu_get_account_local_exchange_setting¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_account_local_exchange_setting"
说明:
Read account funding rules for currently authorized real accounts. Settings writes require acc:read and trade:real with explicit intent; no transfer is performed. Reads are enabled by default; settings writes retain their independent opt-in. Live backend behavior is 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_account_local_exchange_setting",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
权限:acc:read。通过 c2s_json 传入显式请求,按当前账户及市场权限校验。详见融资与自动换汇设置。默认启用,设置需独立启用;真实后端尚未验证。
futu_get_forex_orders¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_forex_orders"
说明:
List Forex orders. view: today, open, recent_three_days, recent, history. History uses history_filter; top-level times/side are exclusive to non-history views. Requires acc:read and FX/account permission; 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_forex_orders",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
权限:acc:read,并核对 FX 和目标账户权限。默认启用,真实后端尚未验证。完整字段与状态语义见外汇订单合同。写入不自动重试。
futu_get_forex_order_detail¶
- Scope:
acc:read - Python SDK 等价:
— - 路由: MCP JSON-RPC
tools/callname ="futu_get_forex_order_detail"
说明:
Read one Forex order by broker_id, account_id and order_id; exchange is optional. Requires acc:read and FX/account permission; 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 fielderror(之前静默 drop)。
JSON-RPC 调用示例:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "futu_get_forex_order_detail",
"arguments": {
"c2s_json": "…",
"api_key": "optional-per-call-api-key"
}
}
}
返回结构: 与对应 REST endpoint / Python SDK 返回结构一致的 JSON 文本。失败时 MCP CallToolResult.is_error=true + 内容带 {"error": "...", "status": "error"}。
补充合同:
权限:acc:read,并核对 FX 和目标账户权限。默认启用,真实后端尚未验证。完整字段与状态语义见外汇订单合同。写入不自动重试。