Mobula - 多链加密数据智能平台
实时加密市场数据、钱包追踪以及跨 88+ 条区块链 的链上分析。提供被 Chainlink、Supra 和 API3 等信任的预言机级定价。
何时使用此技能
使用场景:当用户:
- 询问任何代币的价格、交易量、市值或价格变化
- 想查看钱包的持仓或投资组合价值
- 需要历史价格数据用于图表或分析
- 提到合约地址并希望获取代币信息
- 询问特定链上的代币(如 Base、Arbitrum、Solana 等)
- 想要跨链投资组合概览
- 需要一次性获取多个代币的批量数据
- 询问代币的流动性、ATH、ATL 或交易量
- 想追踪巨鲸钱包或监控重大交易
- 需要查找符合特定条件的新代币
不要使用:
- 用户想执行交易(请使用 bankr 技能)
- 用户想获取 DEX 交换报价(请使用 defi 技能)
- 用户想获取特定交易所数据(请使用 okx/binance 技能)
核心功能
1. 市场数据 (mobula_market_data)
接口: GET https://api.mobula.io/api/1/market/data
获取任何代币在所有支持链上的实时价格、交易量、市值和流动性。
参数:
asset(必需):代币名称、符号或合约地址- 示例:“Bitcoin”、“ETH”、“0x532f27101965dd16442e59d40670faf5ebb142e4”
blockchain(可选):要查询的特定区块链- 示例:“base”、“arbitrum”、“ethereum”、“solana”、“polygon”
返回:
- 当前价格(美元)
- 价格变化:1小时、24小时、7天、30天(百分比和绝对值)
- 交易量(24小时)
- 市值
- 完全稀释估值
- 流动性
- 历史最高价(ATH)和历史最低价(ATL)及对应日期
- 总供应量、流通供应量
使用示例:
- “比特币的价格是多少?”
- “显示 Base 链上 BRETT 的市场数据”
- “获取合约 0x532f27101965dd16442e59d40670faf5ebb142e4 的数据”
- “ETH 现在是在涨还是在跌?”
- “PEPE 的市值是多少?”
何时使用:
- 用户询问任何代币的价格
- 用户想知道某种代币是否在涨跌
- 分析代币基本面(市值、流动性、交易量)
- 比较代币
- 设置价格警报
2. 钱包投资组合 (mobula_wallet_portfolio)
接口: GET https://api.mobula.io/api/1/wallet/portfolio
通过单次调用获取任何钱包在全部 88 条链上的完整投资组合。
参数:
wallet(必需):钱包地址- 格式:“0x...”或 ENS 名称(例如:“vitalik.eth”)
blockchains(可选):用逗号分隔的列表,用于过滤特定区块链- 默认:所有链
cache(可选):使用缓存数据(速度更快,但数据新鲜度略低)
返回:
- 所有持有的代币,包括:
- 代币名称、符号、地址
- 余额(数量和美元价值)
- 当前价格
- 24小时价格变化
- 估计盈亏
- 区块链
- 总投资组合价值(美元)
- 按代币划分的投资组合分配(百分比)
- NFT(如有)
使用示例:
- “显示钱包 0x123... 的投资组合”
- “vitalik.eth 持有哪些代币?”
- “检查我的钱包余额”
- “这个钱包的总价值是多少?”
- “显示这个钱包中排名前 5 的持仓”
何时使用:
- 投资组合追踪
- 钱包分析
- 交易前后检查持仓
- 监控分配情况
- 设置投资组合警报
3. 历史价格数据 (mobula_market_history)
接口: GET https://api.mobula.io/api/1/market/history
获取任何代币在灵活时间范围内的历史价格数据。
参数:
asset(必需):代币名称、符号或地址from(可选):开始时间戳(Unix 秒)to(可选):结束时间戳(Unix 秒)period(可选):数据粒度- 选项:“1h”、“1d”、“1w”
- 默认:根据时间范围自动选择
返回:
- 带有时间戳的价格点数组
- 每个时间点的交易量
- 每个时间点的市值
使用示例:
- “显示过去 30 天的 ETH 价格”
- “这个代币在 1 月 1 日的价格是多少?”
- “这个代币本周一直在涨还是跌?”
- “绘制过去 7 天 BTC 的价格走势图”
何时使用:
- 分析趋势
- 计算历史盈亏
- 比较不同时间范围的价格走势
- 识别模式(突破、支撑、阻力)
4. 近期交易 (mobula_market_trades)
接口: GET https://api.mobula.io/api/1/market/trades
任何代币在所有 DEX 和链上的实时交易流。
参数:
asset(必需):代币名称、符号或地址limit(可选):要返回的交易数量(默认:50,最大:300)
返回:
- 近期交易数组,包含:
- 时间戳
- 类型(买入/卖出)
- 数量(代币数量和美元价值)
- 交易价格
- 钱包地址(买方/卖方)
- DEX 和区块链
- 交易哈希
使用示例:
- “显示这个代币的近期交易”
- “现在谁在买入 PEPE?”
- “这个代币上有巨鲸活动吗?”
- “这个代币的最后 10 笔交易是什么?”
何时使用:
- 巨鲸观察
- 检测异常活动(大额买入/卖出)
- 交易量验证
- 情绪分析(买入 vs 卖出数量)
5. 钱包交易历史 (mobula_wallet_transactions)
接口: GET https://api.mobula.io/api/1/wallet/transactions
任何钱包在所有链上的完整交易历史。
参数:
wallet(必需):钱包地址from(可选):开始时间戳to(可选):结束时间戳asset(可选):按特定代币过滤limit(可选):交易数量(默认:100)
返回:
- 交易数组:
- 类型(交换、转账、铸造、销毁)
- 涉及的代币(从/到)
- 数量
- 交易时的美元价值
- 时间戳
- 区块链
- 交易哈希
使用示例:
- “这个钱包最近买了什么?”
- “显示 0x123... 的最后 10 笔交易”
- “这个钱包上次卖出 ETH 是什么时候?”
- “追踪这个巨鲸的活动”
何时使用:
- 钱包监控
- 巨鲸追踪
- 模式检测(他们买入/卖出的内容)
- 交易验证
6. 多资产数据 (mobula_market_multi)
接口: GET https://api.mobula.io/api/1/market/multi-data
通过单个请求获取多个代币的市场数据(批量接口)。
参数:
assets(必需):用逗号分隔的代币名称/符号/地址列表- 示例:“Bitcoin,Ethereum,Solana”或“BTC,ETH,SOL”
- 每请求最多 500 个代币
返回:
- 与
mobula_market_data相同的数据,但适用于多个代币 - 适用于投资组合分析、观察列表、市场概览
使用示例:
- “比较 BTC、ETH 和 SOL 今天的表现”
- “显示我观察列表中的前几大波动币”
- “获取这 10 个代币的价格:[列表]”
何时使用:
- 投资组合估值
- 观察列表更新
- 市场概览(主流币种)
- 批量价格检查
7. 代币元数据 (mobula_metadata)
接口: GET https://api.mobula.io/api/1/metadata
获取任何代币的详细元数据。
参数:
asset(必需):代币名称、符号或地址
返回:
- 名称、符号、图标
- 描述
- 网站、Twitter、Telegram、Discord 链接
- 所有链上的合约地址
- 上线日期
- 分类/标签
使用示例:
- “告诉我关于这个代币的信息”
- “这个项目的网站是什么?”
- “我在哪里可以找到他们的社区?”
何时使用:
- 研究新代币
- 验证合法性
- 查找官方链接
身份验证
必需: 所有 API 请求都需要通过 API 密钥进行身份验证。
设置:
- 在 https://mobula.io 获取免费 API 密钥(免费套餐每分钟 100 次请求)
- 设置环境变量:
export MOBULA_API_KEY="your_key_here" - 重启 OpenClaw 代理
请求头格式:
Authorization: ${MOBULA_API_KEY}
如果身份验证失败(401/403):
- 验证密钥是否已设置:
echo $MOBULA_API_KEY - 如果密钥过期,请在 https://mobula.io 重新生成
- 检查速率限制(免费套餐每分钟 100 次请求,升级可获更多)
隐私与安全
重要 - 使用前请阅读:
此技能访问的内容
- 仅公共区块链数据:钱包地址、代币价格、交易历史
- 无私钥:切勿向此技能提供私钥、助记词或密码
- 无敏感凭证:技能仅需 Mobula API 密钥(用于访问公共数据)
钱包地址隐私
- 通过此技能查询的钱包地址会发送至 Mobula 的 API (https://api.mobula.io)
- 查询钱包地址会公开其持仓(链上数据本就是公开的)
- 仅使用您愿意分享的公共钱包地址
- 切勿输入 您希望保密或与身份关联的地址
API 密钥范围
- Mobula API 密钥提供对公共区块链数据的只读访问
- 可在 https://mobula.io 对密钥进行范围限定、轮换和撤销
- 免费套餐:每分钟 100 次请求
- 建议为测试和生产环境使用不同的 API 密钥
数据保留
- Mobula 可能会记录 API 请求用于分析和速率限制
- 请参阅 Mobula 的隐私政策:https://mobula.io/privacy
- 不要查询您认为敏感的钱包或数据
最佳实践
- 使用临时/测试 API 密钥进行初始测试
- 仅查询公共钱包地址(例如 vitalik.eth、知名地址)
- 如注重隐私,请避免查询您的个人钱包
- 定期轮换 API 密钥
- 在 https://mobula.io 监控速率限制和使用情况
使用心跳的智能监控模式
OpenClaw 的心跳系统大约每 30 分钟检查一次条件。用于主动监控。
模式 1:投资组合守护
每次心跳:
- 通过
mobula_wallet_portfolio获取用户钱包 - 计算分配百分比
- 检查条件:
- 任何代币占投资组合 >40% → 建议重新平衡
- 任何代币 24h 内跌幅 >15% → 发送上下文警报
- 总投资组合变化 >10% → 通知
- 将先前值存储在内存中以检测变化
- 在用户设定的时间发送每日总结
模式 2:巨鲸观察
每次心跳:
- 通过
mobula_wallet_transactions检查被追踪钱包的交易 - 如果有新的重大交易(>5 万美元):
- 通过
mobula_market_data获取代币详情 - 通过
mobula_market_trades检查近期交易 - 交叉检查其他被追踪巨鲸是否购买了同一代币
- 通过
- 如果多个巨鲸买入 → 优先警报
模式 3:代币侦察(自主发现)
每 4-6 小时心跳一次:
- 用户定义标准(存储在内存中):
- 链:Base、Arbitrum
- 市值:<500 万美元
- 流动性:>10 万美元
- 24h 交易量变化:>+50%
- 通过
mobula_market_data查询搜索/过滤代币 - 对每个匹配:
- 通过
mobula_market_history获取 7 天历史 - 通过
mobula_metadata检查元数据 - 计算风险评分
- 通过
- 发送前 3 名并附分析
模式 4:智能价格警报
代替简单的“价格 > X”警报,创建上下文相关的警报:
示例:“如果比特币在 1 小时内波动 >5%,且交易量是 24 小时平均值的 2 倍以上,则提醒我”
每次心跳:
- 通过
mobula_market_data获取当前价格和交易量 - 与 1 小时前的价格(存储在内存中)进行比较
- 检查交易量条件是否满足
- 仅当两个条件都成立时发送警报
组合多个接口以获取丰富洞察
示例:完整代币分析
用户问:“我该买这个代币吗?”
mobula_market_data→ 当前价格、市值、交易量、流动性mobula_market_history→ 7 天和 30 天趋势mobula_market_trades→ 近期活动(吸筹还是派发?)mobula_metadata→ 项目信息、社交信息、合约验证
响应格式:
TOKEN 分析
价格:$0.042(24h 下跌 8%,7d 上涨 156%)
- 接近 7d 高点,从 $0.051 回落
- 但仍比 30d 低点上涨 400%
基本面:
- 市值:210 万美元(小市值,高风险/高回报)
- 流动性:28 万美元(规模尚可)
- 交易量:120 万美元(24h)(健康)
链上:
- 近期交易显示买入压力(买卖比 3:1)
- 过去 2 小时内出现 2 笔大额买入(>5 万美元)
项目:
- 合约已验证
- Twitter 活跃(1.2 万关注者)
风险:小市值,高波动性。不要投入超过你能承受损失的金额。
响应格式指南
价格
- 始终显示方向:“上涨 12.4%”或“下跌 3.2%”
- 包含时间范围:“上涨 12.4%(24h)”
- 添加上下文:“价格 $0.042(24h 上涨 12%,较 ATH 下跌 8%)”
大数字
- 清晰格式化:“123 万美元”、“45.6 万美元”、“456 亿美元”
- 不要:“1234567”
百分比
- 用于分配:“ETH:占投资组合的 42%”
- 用于变化:“24h 内下跌 15.3%”
上下文是关键
不要只说“价格是 $0.003” 要说:“价格 $0.003(24h 下跌 8%,较 12 月 1 日 ATH $0.089 下跌 65%,但较 7d 低点上涨 12%)”
常见用户请求及处理方法
“为 [代币] 设置警报”
- 确认请求
- 询问具体条件(价格阈值?百分比变动?交易量激增?)
- 确认将通过心跳监控
- 将警报配置存储在内存中
- 确认:“我将每 30 分钟检查 [代币],并在 [渠道] 上向您发出 [条件] 警报”
“追踪这个钱包”
- 将钱包添加到监控列表
- 询问要关注什么:
- 所有活动?
- 仅大额交易(>X 美元)?
- 特定代币?
- 存储在内存中
- 确认监控已激活
“查找符合 [标准] 的代币”
- 明确标准:
- 链?
- 市值范围?
- 交易量要求?
- 最低流动性?
- 设置定期检查(建议 4-6 小时间隔)
- 询问他们想要多少个结果
- 在下一次心跳开始监控
“现在加密货币市场发生了什么?”
- 通过
mobula_market_multi检查主要代币(BTC、ETH、SOL、BNB) - 识别任何重大变动(24h 内 >5%)
- 检查交易量领先者
- 提供简洁概览
错误处理
API 密钥问题
- 未设置密钥: “我需要一个 Mobula API 密钥来获取加密数据。在 https://mobula.io 免费获取一个,然后通过
export MOBULA_API_KEY='your_key'将其添加到你的环境中” - 无效密钥: “你的 API 密钥似乎无效。请检查密钥是否设置正确,或在 https://mobula.io 重新生成”
- 达到速率限制: “你已达到 API 速率限制。免费套餐每分钟允许 100 次请求。请稍后再试或考虑升级”
数据不可用
- 代币未找到: “我无法在 Mobula 上找到该代币。请检查名称、符号或合约地址是否拼写正确”
- 钱包未找到: “我无法获取该钱包的数据。请确保地址正确且为有效格式(0x... 或 .eth)”
- 区块链不支持: “我无法在该区块链上找到该代币。请尝试指定不同的链或省略区块链参数以在所有链上搜索”
网络问题
- 超时: “请求超时。Mobula 服务可能暂时不可用。请稍后再试”
- 服务器错误(5xx): “Mobula 服务遇到错误。请稍后重试,如问题持续存在,请联系 Mobula 支持”
交互示例
示例 1:查询代币价格
用户: “ETH 的价格是多少?”
代理动作: 调用 mobula_market_data(asset='ETH')
代理响应:
ETH 价格:$3,245.67
24h 变化:上涨 2.34%
市值:3,902 亿美元
24h 交易量:187 亿美元
流动性质押率:28.4%
示例 2:钱包分析
用户: “显示 vitalik.eth 的投资组合”
代理动作: 调用 mobula_wallet_portfolio(wallet='vitalik.eth')
代理响应:
vitalik.eth 的投资组合
总计:约 842 万美元
主要持仓:
1. ETH:3,200 个(约 1,038 万美元,占投资组合的 123%)*
*注意:该钱包包含大量 ETH,可能与总价值计算存在差异。
示例 3:趋势分析
用户: “这个代币 [地址] 表现如何?”
代理动作: 调用 mobula_market_data(asset='0x...') 和 mobula_market_history(asset='0x...', period='1d')
代理响应:
代币分析 [代币名称]
当前价格:$0.042
24h 变化:下跌 8.2%
7d 表现:上涨 156%
趋势:
- 从 7d 高点 $0.051 回落(下跌 17.6%)
- 但较 30d 低点 $0.0084 上涨 400%
- 24h 交易量:120 万美元(健康)
近期交易:买卖比 3:1(买入压力)
限制
- Mobula 不提供订单簿数据或交易执行(请使用 bankr/defi 技能)
- 某些链的覆盖范围或更新频率可能不如其他链
- NFT 支持有限(如果需要,请使用 nft 技能)
- 数据最多可能延迟几秒
- 免费套餐每分钟限 100 次请求
支持与资源
- Mobula 文档: https://docs.mobula.io
- Mobula 仪表盘: https://mobula.io/dashboard
- API 控制台: https://mobula.io/console
- 社区/支持: https://discord.gg/mobula
- API 状态: https://status.mobula.io