Skip to main content
可作为 MCP tool 调用：personal_holdings —— 可直接在 Claude / Cursor / 任意 MCP 客户端中调用。接入方式见 MCP Server。
已上线   免费 · 0 credits

​
它为 Agent 做什么

personal_holdings 返回你在 Dashboard → Profile 保存的持仓。Agent 需要你的组合上下文时调用它，比如集中度检查、“我持有什么”、按资产类别过滤，或基于你的持仓做研究。 这个工具只读。它不会下单，不会连接券商账户，也不会读取实时账户余额。返回值是你在 Profile 保存的值；如果答案需要当前市场数据，请再调用行情工具。 只返回你自己账号的 Profile 数据。

​
返回值

​
data
object
required
当前调用者自己账号的已保存持仓信封。
​
data.holdings[]
PersonalHolding
required
​
meta.creditsUsed
number
始终为 0 —— 这次读取免费。
​
meta.remainingCredits
number
账号剩余 credits。
200 OK · personal_holdings
{
  "data": {
    "total_count": 2,
    "holdings": [
      {
        "symbol": "AAPL",
        "name": "Apple Inc.",
        "asset_class": "equity",
        "quantity": 10,
        "market_value": 2120.5,
        "cost_basis": 1800,
        "currency": "USD",
        "as_of_date": "2026-06-21"
      },
      {
        "symbol": "BTC",
        "name": "Bitcoin",
        "asset_class": "crypto",
        "quantity": 0.25,
        "market_value": 25000,
        "cost_basis": null,
        "currency": "USD",
        "as_of_date": "2026-06-21"
      }
    ]
  },
  "meta": { "creditsUsed": 0, "remainingCredits": 100 }
}
200 OK · 空持仓
{
  "data": { "total_count": 0, "holdings": [] },
  "meta": { "creditsUsed": 0, "remainingCredits": 100 }
}

​
说明

用户问和自己组合相关的问题时，先调用 personal_holdings，再只针对相关 ticker 调行情或申报文件工具。这样 Agent 的注意力会留在用户已保存的持仓上。
你账号下任何仍有效的 API key 或 Remote MCP URL 都可以读取这些已保存的 Profile 数据，直到你删除已保存的行或吊销对应凭证。
返回值是用户保存的 Profile 值，不是实时行情，也不是券商账户余额。需要当前市场数据时，请调用行情工具。

​
直接调用

{
  "method": "tools/call",
  "params": {
    "name": "personal_holdings",
    "arguments": { "asset_class": "equity", "limit": 10 }
  }
}

​
完整参数参考

​
asset_class
string
可选过滤条件。取值为 equity、etf、crypto、cash、fund、bond 或 other。
​
limit
number
default:30
最多返回的持仓数量。范围 1-50；超过 50 会按 50 处理。

​
相关接口

个人 Profile

读取已保存的风险偏好、投资期限、基准币种和备注。

MCP Server 接入

60 秒接入 Claude / Cursor / 任意 agent harness。