区块链监控

CatFee 区块链监控服务可以帮助用户实时获取区块链数据的变化，如交易、余额、区块等。 🔗 该服务基于 CatFee 区块链网络，提供了多种接口和工具，支持BTC，ETH，TRON链，专业级监控服务，方便用户进行区块链数据的查询和分析。

支持 URL接收回执 与 Telegram bot 通知

您可以通过以下方式接收 CatFee 区块链监控服务的回执通知：

1. 您可以将您的回调 URL 发送给我们，我们将在区块链数据变化时向您发送通知。

2. 您可以将您的 Telegram bot 与我们的服务绑定，我们将在区块链数据变化时向您发送通知。

URL通知：

当监测到区块链交易（如 USDT、ETH 等币种）的金额变动时，我们会通过您提供的回调 URL 向您推送通知信息。通知内容包含：交易哈希、区块编号、监测地址、付款地址、合约地址、收款地址、交易金额、币种、公链等重要信息。我们采用可靠的重发机制，确保通知送达：

• 首次通知失败后，将按照特定时间间隔重新发送

• 🔔通知规则说明

  ✅成功接收回调请求后，请返回 success 以通知服务器

  🛑服务器收到 success 后，通知将立即停止

  ⏱️未收到 success 时，将按以下频率发送10次通知：

  0秒 → 15秒 → 30秒 → 3分钟 → 10分钟 → 20分钟 → 30分钟 → 60分钟 → 3小时 → 6小时

• 收到成功响应后立即终止重发

接收方只需返回字符串 'success' 即可确认收到通知，建议异步处理业务逻辑并使用 chain+txn_hash 作为主键防重。 API 使用示例

请求方式

POST {您的回调URL}

请求参数（JSON）

{
    "txn_hash": "0x1a2b3c4d5e...",  // 交易哈希
    "block_id": 123456789,      // 区块编号
    "address": "0xABC123...",   // 监测地址
    "from_address": "0xDEF456...", // 付款地址
    "to_address": "0xJKL012...",  // 收款地址
    "contract_address": "0xGHI789...", // 合约地址
    "amount": 1000000,          // 原始金额
    "decimals": 6,              // 金额精度
    "currency": "USDT",         // 币种
    "chain": "ETH",             // 公链
    "paid_at": 1684789012,      // 交易时间戳
    "notify_type": "BLOCK_AMOUNT_CHANGE" // 通知类型
  }

响应示例

"success"

Node.js 接收示例

const express = require('express');
  const app = express();
  app.use(express.json());
  
  app.post('/webhook', async (req, res) => {
    try {
      const notification = req.body;
      
      // 使用 chain+txn_hash 作为主键防重
      const key = `${notification.chain}-${notification.txn_hash}`;
      
      // 异步处理业务逻辑
      process.nextTick(() => {
        processNotification(notification);
      });
  
      // 立即返回成功响应
      res.send('success');
    } catch (error) {
      console.error('处理通知失败:', error);
      res.status(500).send('error');
    }
  });
  
  app.listen(3000, () => {
    console.log('Webhook 服务已启动');
  });

Telegram bot 通知 当监测到区块链交易（如 USDT、ETH 等币种）的金额变动时，我们将通过您的 Telegram bot 向您发送通知信息。

使用步骤

1. 1

   申请机器人

   • 打开Telegram，搜索并添加【@BotFather】
   • 输入命令 /newbot 开始创建新机器人

   • 按照提示设置机器人的名称和用户名

   • 记录下生成的机器人token，这是后续绑定的关键

2. 2

   绑定机器人到Catfee

   • 登录Catfee.io个人中心，选择机器人设置页面输入机器人的token

   • 点击"绑定"按钮，完成机器人绑定

   • 绑定后同步开通能量售卖机器人，免费使用哦！

3. 3

   配置机器人接收通知

   • 将机器人添加到需要接收钱包监控变更消息的会话中

   • 在Catfee.io个人中心中，选择"添加监控钱包"

   • 输入会话ID，确保机器人能正确接收通知

4. 4

   设置监控参数

   • 在监控钱包页面，选择需要监听的区块链类型

   • 输入需要监控的钱包地址

   • 选择 [Telegram bot] 类型，设置需要监听的区块链类型（BTC | ETH | TRON）

   • 设置会话ID，可以选择频道、群组或个人会话

什么是 telegram 会话ID？

会话ID 是用于标识 Telegram 用户、群组或频道的唯一数字标识符。个人用户的会话ID为正整数（如：8090000000），群组的会话ID为负整数（如：-4980000000）。

会话ID 获取方法：

1. 访问 Telegram 机器人：@CatFeeProBot
2. 向机器人发送 "/tools" 命令

3. 在弹出的工具列表中选择会话ID查询工具

4. 机器人将返回当前会话的ID，例如：

   • 用户ID返回格式：用户ID:8090000000 （其中 8090000000 即为用户会话ID）

   • 群组ID返回格式：群组ID:-4980000000 （其中 -4980000000 即为群组会话ID）

通过以上步骤，您可以轻松实现区块链钱包的实时监控，确保不错过任何重要的余额变动。

区块链地址监控api的帮助教程可以点击这里查阅：https://catfee.io/zh/blockchain/monitoring/