工具与参数参考
从公开契约生成的工具、权限和参数清单。
本页由公开契约生成。使用方法见 MCP / CLI 接入。当前工具访问管理员实例中的同一套家庭数据。
get_capabilities
返回当前实例、数据代次、调用身份、权限及可用工具。写入前读取并保留实例与数据代次。
权限：已认证即可；只读操作。
| 参数 | 类型 | 必填 |
|---|
list_accounts
分页读取账户类型、用途、记录方式及最近总额来源，不刷新行情。
权限：assets:read；只读操作。
| 参数 | 类型 | 必填 |
|---|---|---|
limit | integer | 否 |
cursor | string | 否 |
list_holdings
分页查询投资理财用途账户的持仓，可按账户或证券代码筛选。
权限：assets:read；只读操作。
| 参数 | 类型 | 必填 |
|---|---|---|
limit | integer | 否 |
cursor | string | 否 |
account_id | integer | 否 |
ticker | string | 否 |
get_holding
按持仓 ID 读取详情和版本；不同账户的同一证券是不同持仓。
权限：assets:read；只读操作。
| 参数 | 类型 | 必填 |
|---|---|---|
id | integer | 是 |
list_trades
分页查询普通买卖交易，不包含定投和组合资金流水。
权限：assets:read；只读操作。
| 参数 | 类型 | 必填 |
|---|---|---|
limit | integer | 否 |
cursor | string | 否 |
holding_id | integer | 否 |
direction | buy / sell | 否 |
date_from | string | 否 |
date_to | string | 否 |
get_trade
根据交易 ID 查看保存的普通交易，不修改账本。
权限：assets:read；只读操作。
| 参数 | 类型 | 必填 |
|---|---|---|
id | integer | 是 |
preview_trade
只读重放历史账本，返回新增交易对持仓数量和成本的影响；不保存、不锁定状态。
权限：assets:read；只读操作。
| 参数 | 类型 | 必填 |
|---|---|---|
holding_id | integer | 是 |
direction | buy / sell | 是 |
trade_date | string | 是 |
quantity | number | 是 |
unit_price | number | 是 |
fee | number | 是 |
currency | string | 是 |
note | 见接入说明 | 否 |
expected_holding_version | string | 否 |
create_trade
根据用户明确提供的成交信息记账。需要固定 request_id、instance_id 和 data_generation；超时重试保留原值。返回 saved 才表示已保存。
权限：assets:read、trades:create；写入操作。
| 参数 | 类型 | 必填 |
|---|---|---|
holding_id | integer | 是 |
direction | buy / sell | 是 |
trade_date | string | 是 |
quantity | number | 是 |
unit_price | number | 是 |
fee | number | 是 |
currency | string | 是 |
note | 见接入说明 | 否 |
expected_holding_version | string | 否 |
request_id | string | 是 |
instance_id | string | 是 |
data_generation | integer | 是 |
create_holding
在已有投资账户中建立零期初、按数量单价计价的空持仓。首次买入须另外新增交易；不能同时导入已有数量。
权限：assets:read、holdings:create；写入操作。
| 参数 | 类型 | 必填 |
|---|---|---|
request_id | string | 是 |
instance_id | string | 是 |
data_generation | integer | 是 |
account_id | integer | 是 |
name | string | 是 |
type | stock / fund / bond / gold / other | 是 |
ticker | string | 是 |
currency | string | 是 |
underlying_asset_class | cash / equity / fixed_income / commodity / mixed / other / unclassified | 否 |