通过明确字段与结构化筛选查询链上数据表。返回使用明确字段和结构化筛选从支持链上表选择的查询行。 通过一个 Toolmu 账号，使用可用工具之间共享的预付费余额。按次付费，无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0288 Toolmu 积分。这是上限，不是已结算费用。执行前应获取最新 Tool 契约，核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used（如有）表示来源 API 积分，不是 Toolmu 客户费用。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
Surf
通过明确字段与结构化筛选查询链上数据表。返回使用明确字段和结构化筛选从支持链上表选择的查询行。 通过一个 Toolmu 账号，使用可用工具之间共享的预付费余额。按次付费，无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0288 Toolmu 积分。这是上限，不是已结算费用。执行前应获取最新 Tool 契约，核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used（如有）表示来源 API 积分，不是 Toolmu 客户费用。
返回使用明确字段和结构化筛选从支持链上表选择的查询行。 可用列取决于所选表。应先查表结构并限定筛选和行数；不能认为存在固定通用行结构。
查询[Ethereum]上从[2026-10-01]起的代币兑换记录，最多[20]条，并按金额从高到低排列。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
bodybody | object | 必填 |
|
sortbody.sort | array | 选填 | ORDER BY 排序条件。示例：[{"field": "amount_usd", "order": "desc"}]。 |
[]body.sort[] | object | — |
|
fieldbody.sort[].field | string | — | 用于排序的列名。示例：amount_usd。
|
orderbody.sort[].order | string | — | 排序方向，默认 asc。示例：desc。
|
limitbody.limit | integer | 选填 | 最多返回的行数，服务端默认 20，上限为 10000。示例：20。
|
fieldsbody.fields | array | 选填 | 要返回的列，省略时返回全部列。示例：["block_time", "amount_usd"]。 |
[]body.fields[] | string | — |
|
offsetbody.offset | integer | 选填 | 分页时跳过的行数，默认 0。示例：0。
|
sourcebody.source | string | 必填 | 包含命名空间的完整表名，可通过 /onchain/schema 查找。示例：agent.ethereum_dex_trades。
|
filtersbody.filters | array | 选填 | WHERE 筛选条件，各条件之间按 AND 组合。查询大表时务必限制 block_date 范围，否则会超时。示例：[{"field": "block_date", "op": "gte", "value": "2026-07-01"}]。 |
[]body.filters[] | object | — |
|
opbody.filters[].op | string | — | 比较运算符。使用 in/not_in 时，value 必须是 JSON 数组。示例：gte。
|
fieldbody.filters[].field | string | — | 要筛选的列名。示例：block_date。不要按 symbol 列筛选，因为该列未建立索引；请先通过 /search/token 将代币代码解析为合约地址。
|
valuebody.filters[].value | string | number | boolean | array | — | 用于比较的值；使用 in/not_in 时应填写 JSON 数组。示例：2026-07-01。 |
[]body.filters[].value[]anyOf · 4 | string | number | — |
{
"type": "object",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"source"
],
"~standard": {
"vendor": "zod",
"version": 1,
"jsonSchema": {}
},
"properties": {
"sort": {
"type": "array",
"items": {
"type": "object",
"required": [
"field"
],
"properties": {
"field": {
"type": "string",
"minLength": 1,
"description": "用于排序的列名。示例：amount_usd。"
},
"order": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "排序方向，默认 asc。示例：desc。"
}
},
"additionalProperties": false
},
"description": "ORDER BY 排序条件。示例：[{\"field\": \"amount_usd\", \"order\": \"desc\"}]。"
},
"limit": {
"type": "integer",
"maximum": 10000,
"minimum": 1,
"description": "最多返回的行数，服务端默认 20，上限为 10000。示例：20。"
},
"fields": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "要返回的列，省略时返回全部列。示例：[\"block_time\", \"amount_usd\"]。"
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "分页时跳过的行数，默认 0。示例：0。"
},
"source": {
"type": "string",
"pattern": "^agent\\.[a-z0-9_]+$",
"description": "包含命名空间的完整表名，可通过 /onchain/schema 查找。示例：agent.ethereum_dex_trades。"
},
"filters": {
"type": "array",
"items": {
"type": "object",
"required": [
"field",
"op",
"value"
],
"properties": {
"op": {
"enum": [
"eq",
"neq",
"gt",
"gte",
"lt",
"lte",
"like",
"in",
"not_in"
],
"type": "string",
"description": "比较运算符。使用 in/not_in 时，value 必须是 JSON 数组。示例：gte。"
},
"field": {
"type": "string",
"minLength": 1,
"description": "要筛选的列名。示例：block_date。不要按 symbol 列筛选，因为该列未建立索引；请先通过 /search/token 将代币代码解析为合约地址。"
},
"value": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
],
"description": "用于比较的值；使用 in/not_in 时应填写 JSON 数组。示例：2026-07-01。"
}
},
"additionalProperties": false
},
"description": "WHERE 筛选条件，各条件之间按 AND 组合。查询大表时务必限制 block_date 范围，否则会超时。示例：[{\"field\": \"block_date\", \"op\": \"gte\", \"value\": \"2026-07-01\"}]。"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}暂未配置返回字段说明。
通过明确字段与结构化筛选查询链上数据表
使用下列已部署输入字段。必填字段必须提供；可选筛选用于缩小结果范围。
body.sort (可选): ORDER BY 排序条件。示例：[{"field": "amount_usd", "order": "desc"}]。
body.limit (可选): 最多返回的行数，服务端默认 20，上限为 10000。示例：20。
body.fields (可选): 要返回的列，省略时返回全部列。示例：["block_time", "amount_usd"]。
body.offset (可选): 分页时跳过的行数，默认 0。示例：0。
body.source (必填): 包含命名空间的完整表名，可通过 /onchain/schema 查找。示例：agent.ethereum_dex_trades。
body.filters (可选): WHERE 筛选条件，各条件之间按 AND 组合。查询大表时务必限制 block_date 范围，否则会超时。示例：[{"field": "block_date", "op": "gte", "value": "2026-07-01"}]。
返回使用明确字段和结构化筛选从支持链上表选择的查询行。
下表按照官方响应合同列出嵌套字段和有用的响应元数据。[] 表示数组中的一项。“父对象内必填”不代表有条件的父对象一定存在。类型允许 null 时可返回空值；可选字段可以省略。请结合各字段的明确条件区分缺失、空集合和数值 0。只有明确说明时才能确认单位与统计窗口。
字段、类型与是否必填 | 含义与返回条件 |
|---|---|
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 核对。此日期是合同核对日期，不是数据观测时间。实际覆盖取决于所选接口和请求。
通过一个 Toolmu 账号，使用可用工具之间共享的预付费余额。按次付费，无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0288 Toolmu 积分。这是上限，不是已结算费用。执行前应获取最新 Tool 契约，核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used（如有）表示来源 API 积分，不是 Toolmu 客户费用。
查找[Ethereum]上从[2026-10-01]起金额超过[1000 USD]的代币兑换记录，最多显示[10]条。
查询[Ethereum]上从[2026-10-01]起的代币兑换记录，最多[20]条，并按金额从高到低排列。
查看[Ethereum]上[2026-10-01]至[2026-10-07]的代币兑换记录，最多[50]条，最新的排在前面。
body.sort (可选): ORDER BY 排序条件。示例：[{"field": "amount_usd", "order": "desc"}]。 body.limit (可选): 最多返回的行数，服务端默认 20，上限为 10000。示例：20。 body.fields (可选): 要返回的列，省略时返回全部列。示例：["block_time", "amount_usd"]。 body.offset (可选): 分页时跳过的行数，默认 0。示例：0。 body.source (必填): 包含命名空间的完整表名，可通过 /onchain/schema 查找。示例：agent.ethereum_dex_trades。 body.filters (可选): WHERE 筛选条件，各条件之间按 AND 组合。查询大表时务必限制 block_date 范围，否则会超时。示例：[{"field": "block_date", "op": "gte", "value": "2026-07-01"}]。
返回使用明确字段和结构化筛选从支持链上表选择的查询行。
可用列取决于所选表。应先查表结构并限定筛选和行数；不能认为存在固定通用行结构。
通过一个 Toolmu 账号，使用可用工具之间共享的预付费余额。按次付费，无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0288 Toolmu 积分。这是上限，不是已结算费用。执行前应获取最新 Tool 契约，核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used（如有）表示来源 API 积分，不是 Toolmu 客户费用。
请让智能体通过明确字段与结构化筛选查询链上数据表，并提供上方必填输入。已有 Toolmu 连接时直接复用；尚未连接时按此页的配置说明完成连接。付费执行前，智能体应读取最新 Tool 契约，核对可用性、积分上限、余额、预算和你的授权，再执行 Tool 并解释返回字段及限制。
按字段说明检查返回的观测时间、缓存状态、水位、分页和错误。请求成功本身不能证明覆盖完整；来源没有说明时效或完整性保证时，应视为未知。保存的 Example 是历史样本，查看不会刷新数据或执行新调用。