开发者

在 AI 助手、终端或你自己的代码中使用你的投资组合。一切均为只读,且仅涵盖你持有的资产。

连接你的 AI 助手

向 Claude、ChatGPT、Claude Code 或 Cursor 询问你的持仓,或通过对话添加持仓。

适用于网页版、桌面版和移动版的所有 Claude 套餐。免费套餐包含一个自定义连接器。

  1. 你会在设置过程中登录 Sonar。还没有账户?免费创建一个。

    服务器 URL
    https://sonarfolio.com/api/mcp
  2. 打开 Customize,然后选择 Connectors。

    打开 Claude 连接器(在新标签页中打开)
  3. 依次选择 + Add 和 Add custom connector。命名为 Sonar 并粘贴服务器 URL。

  4. 如有询问,选择 Sign in now 和 Use Claude's published identity,无需客户端 ID 和密钥,然后选择 Add。

  5. 选择 Connect,登录并选择允许。在对话中依次选择 + 和 Connectors 将其开启。

试一试:问问你的助手
我最大的五个持仓是什么?

连接器只能看到你持有的资产。它们可以添加你描述的持仓,但无法交易、转移资金或删除任何内容。

故障排除

无法连接或没有显示工具

检查 URL 是否以 /api/mcp 结尾,以及登录是否以允许结束。否则,移除 Sonar 后重新添加。

助手提示需要套餐或额度

你的套餐决定助手能看到什么;每次工具调用计为一次请求。在API 和 AI 工具中查看请求和额度。

你断开了应用或撤销了密钥

访问会立即停止。要重新连接,移除 Sonar,重新添加并登录。

你在 Team 或 Enterprise 套餐中使用 Claude

所有者用服务器 URL 添加一次 Sonar;每位成员登录自己的账户。

REST API

通过 HTTPS 返回 JSON,使用 Bearer 密钥。每个端点都有对应的 MCP 工具和 CLI 命令。

curl https://sonarfolio.com/api/v1/assets \
  -H "Authorization: Bearer YOUR_KEY"
  • GET/api/v1/meMCPget_usageCLIsonar status套餐、访问权限和今日用量Starter
  • GET/api/v1/assetsMCPlist_held_assetsCLIsonar assets你持有的每项资产的市场和社交数据Starter
  • GET/api/v1/assets/{id}MCPget_assetCLIsonar asset <SYMBOL>单项持有资产:报价、社交、头部创作者、90 天收盘价Starter
  • GET/api/v1/assets/search?q=MCPsearch_assetsCLIsonar search <QUERY>查找资产 ID(仅名称)Starter
  • GET/api/v1/portfolioMCPget_portfolioCLIsonar portfolio总计、24 小时变化、盈亏、配置、涨跌榜Standard
  • GET/api/v1/holdingsMCPlist_holdingsCLIsonar holdings [--account NAME]每个账户的全部持仓Standard
  • POST/api/v1/holdingsMCPadd_positionCLIsonar add <SYMBOL> <QUANTITY> [--cost --date --account]添加持仓:{ asset_id, quantity, cost_usd?, date?, account? }写入数据。MCP 客户端会看到它标记为 destructive;CLI 会先询问(--yes 可跳过)。Starter

响应包含数据来源、时间戳和我们的免责声明,以及 X-RateLimit-Limit、-Remaining、-Reset 和 X-Credits-Remaining 请求头。错误:{ error: { code, message } }。

命令行

用同一个密钥,在终端和脚本中使用同样的数据。

安装并登录

npm install -g sonarfolio
sonar login

需要 Node 18 或更高版本。sonar login 会保存来自API 和 AI 工具的密钥;在脚本和 CI 中,请改为设置 SONAR_API_KEY。

更多安装选项

再次运行安装即可更新。无需安装即可试用:npx -p sonarfolio sonar status。从本站安装:npm install -g https://sonarfolio.com/cli/latest.tgz。你的密钥保存在 ~/.config/sonar/config.json,仅你本人可读取。

命令

命令与 REST 端点列在一起,另有 sonar watch [portfolio|assets] 可在每日限额内显示实时视图。

在脚本中使用

sonar holdings --json | jq '.holdings[] | {symbol, value_usd}'

每个命令都支持 --json,并输出 API 的 JSON。

限额和额度

每次 API 调用、MCP 工具调用或 CLI 命令计为一次请求。每日限额在 00:00 UTC 重置。

套餐包含的请求涵盖
Free仅 API 额度价格和你的投资组合
Starter每天 500 次价格、社交数据和添加持仓
Standard每天 1,000 次增加持仓、盈亏、配置和链上数据
Premium每天 2,000 次增加持仓、盈亏、配置和链上数据

端点列表中的套餐名称表示包含该请求的套餐;其他情况在任何套餐中都由 API 额度支付。$1 可购买 1,000 个,额度永不过期,每个账户初始有 100 个。