获取支持链上代币合约的 DEX 价格蜡烛图数据
如何使用这个 Tool
使用下列已部署输入字段。必填字段必须提供;可选筛选用于缩小结果范围。
queryParams.to (可选): 自定义时间范围结束时间(Unix 秒或 YYYY-MM-DD),需与 from 同时设置。
queryParams.from (可选): 自定义时间范围开始时间(Unix 秒或 YYYY-MM-DD),需与 to 同时设置。
queryParams.chain (必填): 代币所在区块链,可选 ethereum、base、bsc、arbitrum、optimism、polygon、avalanche 或 solana。
queryParams.address (必填): 代币合约地址:EVM 链为 0x 开头的 42 位十六进制地址,Solana 为 base58;不是股票代码。
queryParams.interval (可选): K 线时间桶大小,例如 1h,默认 1h。
queryParams.time_range (可选): 要返回的历史数据窗口;max 返回所选周期允许的最大 1500 根 K 线。默认 24h。
返回内容
返回指定链上代币合约的池加权 DEX 美元 OHLC 价格、成交量和时间。
返回字段与解读方式
下表按照官方响应合同列出嵌套字段和有用的响应元数据。[] 表示数组中的一项。“父对象内必填”不代表有条件的父对象一定存在。类型允许 null 时可返回空值;可选字段可以省略。请结合各字段的明确条件区分缺失、空集合和数值 0。只有明确说明时才能确认单位与统计窗口。
覆盖范围、单位与时效
输入应为合约地址而非代币符号。接口返回有上限的蜡烛图历史,不是逐笔成交,也不保证覆盖所有池。
按字段说明检查返回的观测时间、缓存状态、水位、分页和错误。请求成功本身不能证明覆盖完整;来源没有说明时效或完整性保证时,应视为未知。保存的 Example 是历史样本,查看不会刷新数据或执行新调用。
数据来源与引用
此接口的数据由 Surf Data API 提供。响应合同和已部署 Tool 输入于 2026-10-03 按官方 OpenAPI v0.2.102 核对。此日期是合同核对日期,不是数据观测时间。实际覆盖取决于所选接口和请求。
Surf Data API 官方文档
Surf 官方 OpenAPI 合同
通过一个 Toolmu 账号,使用可用工具之间共享的预付费余额。按次付费,无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0072 Toolmu 积分。这是上限,不是已结算费用。执行前应获取最新 Tool 契约,核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used(如有)表示来源 API 积分,不是 Toolmu 客户费用。