查询钱包 DeFi 协议仓位 · Surf

查看钱包已记录的 DeFi 协议持仓。返回已记录协议持仓、链、协议标识、公开引用和可用美元总额。通过一个 Toolmu 账号，使用可用工具之间共享的预付费余额。按次付费，无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0144 Toolmu 积分。这是上限，不是已结算费用。执行前应获取最新 Tool 契约，核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used（如有）表示来源 API 积分，不是 Toolmu 客户费用。

你的 AI

在你的 AI 中使用

多步骤任务，也可以在你常用的 AI 中继续完成。

CodexClaude CodeCursorWindsurfCline

查看指令

使用 Toolmu 的 wallet-defi-protocol-positions-surf 查询用户提供的钱包。若公开 Etherscan 页面链接能明确对应一个钱包，就从链接中识别钱包地址后再查询；无法确认时，请用户换一个能识别钱包的公开页面链接，不要猜测，也不要把昵称当成地址。解释实际查到的持仓、应用或网络，以及可用的美元总额。结果仅覆盖受支持的协议和现有记录；没有结果不代表钱包一定没有持仓。付费执行前核对当前可用性、费用上限、余额、预算和授权；状态不确定时不要重复提交。

任务:
粘贴钱包的公开页面链接，例如 Etherscan 上的钱包页面。我会从链接识别钱包，并查看它在链上金融（DeFi）应用中的持仓。

粘贴到已连接工具的 AI 对话中。

连接指南

每次调用最多 0.0144 积分

按确认的实际用量结算，未使用的预留额度会恢复到可用余额。

Surf

查询钱包 DeFi 协议仓位 · Surf

得到的结果

返回已记录协议持仓、链、协议标识、公开引用和可用美元总额。覆盖以支持协议和可用持仓记录为准。缺少协议不证明钱包在其他协议没有持仓。

从你的任务开始

粘贴钱包的公开页面链接，例如 Etherscan 上的钱包页面。我会从链接识别钱包，并查看它在链上金融（DeFi）应用中的持仓。

输入与输出

开始前检查当前输入要求、可用状态和最高预留费用。

输入参数

输入参数
字段 / 路径	类型	是否必填	含义
queryParams`queryParams`	`object`	必填	必填字段 `address`
limit`queryParams.limit`	`integer`	选填	钱包地址。默认值 `20` 最小值 `1` 最大值 `100`
offset`queryParams.offset`	`integer`	选填	协议或链筛选。默认值 `0` 最小值 `0` 最大值 `9007199254740991`
address`queryParams.address`	`string`	必填	时间范围。最小长度 `1`

查看原始 JSON

{
  "type": "object",
  "required": [
    "queryParams"
  ],
  "properties": {
    "queryParams": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "address"
      ],
      "~standard": {
        "vendor": "zod",
        "version": 1,
        "jsonSchema": {}
      },
      "properties": {
        "limit": {
          "type": "integer",
          "default": 20,
          "maximum": 100,
          "minimum": 1,
          "description": "钱包地址。"
        },
        "offset": {
          "type": "integer",
          "default": 0,
          "maximum": 9007199254740991,
          "minimum": 0,
          "description": "协议或链筛选。"
        },
        "address": {
          "type": "string",
          "minLength": 1,
          "description": "时间范围。"
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

返回结构

暂未配置返回字段说明。

补充说明

查看钱包已记录的 DeFi 协议持仓

如何使用这个 Tool

使用下列已部署输入字段。必填字段必须提供；可选筛选用于缩小结果范围。

queryParams.limit (可选): 钱包地址。

queryParams.offset (可选): 协议或链筛选。

queryParams.address (必填): 时间范围。

返回内容

返回已记录协议持仓、链、协议标识、公开引用和可用美元总额。

返回字段与解读方式

下表按照官方响应合同列出嵌套字段和有用的响应元数据。[] 表示数组中的一项。“父对象内必填”不代表有条件的父对象一定存在。类型允许 null 时可返回空值；可选字段可以省略。请结合各字段的明确条件区分缺失、空集合和数值 0。只有明确说明时才能确认单位与统计窗口。

字段、类型与是否必填	含义与返回条件
data.[].chain string; 父对象内必填	协议运行所在的规范链名称。
data.[].logo_url string; 父对象内可选	协议 Logo 图片地址。
data.[].positions array \| null; 父对象内必填	此协议中的各个持仓。
data.[].positions.[].balance_usd number; 父对象内必填; format: double	此持仓的总价值，单位为美元。
data.[].positions.[].borrow_tokens array \| null; 父对象内可选	此持仓借入的代币。
data.[].positions.[].borrow_tokens.[].amount number; 父对象内必填; format: double	此持仓持有的代币数量。
data.[].positions.[].borrow_tokens.[].chain string; 父对象内必填	规范链名称，例如 ethereum 或 polygon。
data.[].positions.[].borrow_tokens.[].name string; 父对象内可选	代币全名。
data.[].positions.[].borrow_tokens.[].price number; 父对象内必填; format: double	代币当前价格，单位为美元。
data.[].positions.[].borrow_tokens.[].symbol string; 父对象内必填	代币交易符号。
data.[].positions.[].borrow_tokens.[].token_address string; 父对象内可选	代币合约地址。
data.[].positions.[].lp_tokens array \| null; 父对象内可选	此持仓中的 LP 代币。
data.[].positions.[].lp_tokens.[].amount number; 父对象内必填; format: double	此持仓持有的代币数量。
data.[].positions.[].lp_tokens.[].chain string; 父对象内必填	规范链名称，例如 ethereum 或 polygon。
data.[].positions.[].lp_tokens.[].name string; 父对象内可选	代币全名。
data.[].positions.[].lp_tokens.[].price number; 父对象内必填; format: double	代币当前价格，单位为美元。
data.[].positions.[].lp_tokens.[].symbol string; 父对象内必填	代币交易符号。
data.[].positions.[].lp_tokens.[].token_address string; 父对象内可选	代币合约地址。
data.[].positions.[].name string; 父对象内必填	持仓名称或类型，例如 Lending（借贷）或 Staking（质押）。
data.[].positions.[].reward_tokens array \| null; 父对象内可选	此持仓尚未领取的奖励代币。
data.[].positions.[].reward_tokens.[].amount number; 父对象内必填; format: double	此持仓持有的代币数量。
data.[].positions.[].reward_tokens.[].chain string; 父对象内必填	规范链名称，例如 ethereum 或 polygon。
data.[].positions.[].reward_tokens.[].name string; 父对象内可选	代币全名。
data.[].positions.[].reward_tokens.[].price number; 父对象内必填; format: double	代币当前价格，单位为美元。
data.[].positions.[].reward_tokens.[].symbol string; 父对象内必填	代币交易符号。
data.[].positions.[].reward_tokens.[].token_address string; 父对象内可选	代币合约地址。
data.[].positions.[].supply_tokens array \| null; 父对象内可选	此持仓提供或存入的代币。
data.[].positions.[].supply_tokens.[].amount number; 父对象内必填; format: double	此持仓持有的代币数量。
data.[].positions.[].supply_tokens.[].chain string; 父对象内必填	规范链名称，例如 ethereum 或 polygon。
data.[].positions.[].supply_tokens.[].name string; 父对象内可选	代币全名。
data.[].positions.[].supply_tokens.[].price number; 父对象内必填; format: double	代币当前价格，单位为美元。
data.[].positions.[].supply_tokens.[].symbol string; 父对象内必填	代币交易符号。
data.[].positions.[].supply_tokens.[].token_address string; 父对象内可选	代币合约地址。
data.[].protocol_name string; 父对象内必填	便于阅读的协议名称。
data.[].site_url string; 父对象内可选	协议网站链接。
data.[].total_usd number; 父对象内必填; format: double	此协议所有持仓的总价值，单位为美元。
meta.cached boolean; 父对象内必填	该响应是否来自缓存。
meta.credits_used integer; 父对象内必填; format: int64	来源 API 为该请求扣除的积分；此字段属于来源 API，不等同于 Toolmu 客户积分上限。
meta.empty_reason string; 父对象内可选	数据数组为空时的原因提示，仅在适用时提供。
meta.has_more boolean; 父对象内可选	是否可能还有未返回的数据。offset 分页接口可增加 offset 继续查询；没有 offset/cursor 的时间序列接口返回 true 时，表示时间范围触及上游上限，应缩小 from/to。无法确认是否已取完时省略。
meta.limit integer; 父对象内必填; format: int64	本次响应最多返回的项目数。
meta.offset integer; 父对象内必填; format: int64	已跳过的项目数，即分页偏移量。
meta.total integer; 父对象内可选; format: int64	分页前的匹配项目总数；总数未知时省略。
meta.watermark integer; 父对象内可选; format: int64	本次计算采用的数据仓库水位时间，单位为 Unix 秒。仓库接口中，水位以前的数据来自仓库，更新的数据来自实时尾部；其他接口省略。

覆盖范围、单位与时效

覆盖以支持协议和可用持仓记录为准。缺少协议不证明钱包在其他协议没有持仓。

按字段说明检查返回的观测时间、缓存状态、水位、分页和错误。请求成功本身不能证明覆盖完整；来源没有说明时效或完整性保证时，应视为未知。保存的 Example 是历史样本，查看不会刷新数据或执行新调用。

数据来源与引用

此接口的数据由 Surf Data API 提供。响应合同和已部署 Tool 输入于 2026-10-03 按官方 OpenAPI v0.2.102 核对。此日期是合同核对日期，不是数据观测时间。实际覆盖取决于所选接口和请求。

Surf Data API 官方文档

Surf 官方 OpenAPI 合同

通过一个 Toolmu 账号，使用可用工具之间共享的预付费余额。按次付费，无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0144 Toolmu 积分。这是上限，不是已结算费用。执行前应获取最新 Tool 契约，核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used（如有）表示来源 API 积分，不是 Toolmu 客户费用。

关于这个工具，你可能还想知道。

输入要求、结果含义，以及使用前需要了解的细节。

连接指南

请粘贴钱包的公开页面链接，例如 Etherscan 上的钱包页面。链接需要能明确识别钱包，单独提供昵称无法查询。

查询钱包 DeFi 协议仓位 · Surf

查询钱包 DeFi 协议仓位 · Surf

得到的结果

从你的任务开始

输入与输出

输入参数

返回结构

如何使用这个 Tool

返回内容

返回字段与解读方式

覆盖范围、单位与时效

数据来源与引用

查看这个钱包的 DeFi 持仓

查看持仓美元总值

了解为什么没有显示持仓

关于这个工具，你可能还想知道。

得到的结果

从你的任务开始

输入与输出

输入参数

返回结构

如何使用这个 Tool

返回内容

返回字段与解读方式

覆盖范围、单位与时效

数据来源与引用

查看这个钱包的 DeFi 持仓

查看持仓美元总值

了解为什么没有显示持仓

关于这个工具，你可能还想知道。

我需要提供什么链接？

结果包含什么？

如何理解覆盖范围与单位？

这个 Tool 如何计费？

如何让智能体完成这个任务？

打开页面或 Example 会获取当前数据吗？