> For the complete documentation index, see [llms.txt](https://docs.catfee.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.catfee.io/getting-started/qu-kuai-lian-jian-kong.md).
# 区块链监控
### 支持 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, // 区块编号
"name","我的钱包", // 地址昵称
"address": "T123456...", // 监测地址
"from_address": "T123456...", // 付款地址
"to_address": "T654321...", // 收款地址
"contract_address": "T888888...", // 合约地址
"amount": 1000000, // 原始金额
"decimals": 6, // 金额精度
"currency": "USDT", // 币种
"chain": "TRON", // 公链
"paid_at": 1684789012 // 交易时间戳
}
```
**响应示例**
```
"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】](https://t.me/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](https://t.me/CatFeeProBot)
2. 向机器人发送 `"/tools"` 命令
3. 在弹出的工具列表中选择会话ID查询工具
4. 机器人将返回当前会话的ID，例如：
* 用户ID返回格式：用户ID:8090000000 （其中 8090000000 即为用户会话ID）
* 群组ID返回格式：群组ID:-4980000000 （其中 -4980000000 即为群组会话ID）
通过以上步骤，您可以轻松实现区块链钱包的实时监控，确保不错过任何重要的余额变动。
区块链地址监控api的帮助教程可以点击这里查阅：