用途:通过 Moralis Streams API 建立实时区块链事件监控,将链上事件以 Webhook 推送到指定服务器。适用于设置 Webhook、实时事件流、监控钱包地址等需求。
主要能力:支持多种流类型,包括原生交易(tx)、合约事件日志(log)、ERC20 转账与授权(erc20transfer、erc20approval)、NFT 转账(nfttransfer)、内部交易(internalTx)。提供约 20 个端点,覆盖流的创建、更新、删除、复制、地址增删替换、状态切换、历史回放、统计与日志、区块数据获取等。支持以太坊、Polygon、BSC、Arbitrum、Optimism、Base、Avalanche 等主流 EVM 链。
使用方式:基础地址为 https://api.moralis-streams.com,与 Data API(deep-index.moralis.io)不同。所有请求需带 X-API-Key 头。创建流用 PUT /streams/evm,更新用 POST /streams/evm/{id},删除用 DELETE,列表用 GET /streams/evm 且必须带 limit 参数,替换地址用 PATCH。列表端点使用游标分页(limit 与 cursor)。Webhook 使用 streams secret 签名,请求头为 x-signature,算法为 sha3(JSON.stringify(body) + secret)。
关键限制与常见错误:流 ID 必须为 UUID 格式而非十六进制;链 ID 必须用十六进制(如 0x1、0x89),不能用链名;状态值只能小写(active、paused);创建流误用 POST 会导致错误;GET 列表缺少 limit 会报错;流暂停后不会收到 Webhook。API Key 不应粘贴到聊天中,应通过环境变量 MORALIS_API_KEY 提供,未设置时可创建 .env 占位并加入 .gitignore。无 Key 时无法代为测试或调用 API。
资料还提供规则文件、参考文档与故障排查表,建议实现前先阅读对应端点规则文件。