# Blockchain Monitoring Service
🔗 This service, based on the CatFee blockchain network, provides various interfaces and tools for users to query and analyze blockchain data.
🎁 As a special benefit to our users, we now offer this professional-grade monitoring service free of charge to all CatFee users, making your blockchain asset management more convenient and efficient.
\\
### URL Callback and Telegram Bot Notifications Available
You can receive CatFee blockchain monitoring service notifications through the following methods:
1\. You can send us your callback URL, and we will notify you when blockchain data changes.
2\. You can bind your Telegram bot with our service, and we will send you notifications when blockchain data changes.
Blockchain Monitoring api
URL NotificationWhen blockchain transactions (such as USDT, ETH, etc.) amount changes are detected, we will push notification information to you through your provided callback URL.The notification includes important information such as: transaction hash, block number, monitored address, payment address, contract address, receiving address, transaction amount, currency, and blockchain.We use a reliable resend mechanism to ensure notification delivery:
* If the first notification fails, it will be resent at specific intervals
* **🔔Notification Rules**
✅After successfully receiving the callback request, please return 'success' to notify the server
🛑Notifications will stop immediately after the server receives 'success'
⏱️If 'success' is not received, notifications will be sent 10 times at the following frequency:
0s → 15s → 30s → 3min → 10min → 20min → 30min → 60min → 3h → 6h
* Resending stops immediately upon receiving a success response
The receiver only needs to return the string 'success' to confirm receipt of the notification. It is recommended to process business logic asynchronously and use chain+txn\_hash as the primary key to prevent duplicates.
#### API Usage Example
**Request Method**
POST {Your Callback URL}
**Request Parameters (JSON)**
```
{
"txn_hash": "1a2b3c4d5e...", // Transaction hash
"block_id": 123456789, // Block number
"name":"my wallet", // nickname
"address": "T123456...", // Monitored address
"from_address": "T123456...", // From address
"to_address": "T654321...", // To address
"contract_address": "T888888...", // Contract address
"amount": 1000000, // Original amount
"decimals": 6, // Amount decimals
"currency": "USDT", // Currency
"chain": "TRON", // Chain
"paid_at": 1684789012 // Transaction timestamp
}
```
**Response Example**
```
"success"
```
**Node.js Reception Example**
```
const express = require('express');
const app = express();
app.use(express.json());
app.post('/webhook', async (req, res) => {
try {
const notification = req.body;
// Use chain+txn_hash as primary key to prevent duplicates
const key = `${notification.chain}-${notification.txn_hash}`;
// Process business logic asynchronously
process.nextTick(() => {
processNotification(notification);
});
// Return success response immediately
res.send('success');
} catch (error) {
console.error('Failed to process notification:', error);
res.status(500).send('error');
}
});
app.listen(3000, () => {
console.log('Webhook service started');
});
```
**Telegram Bot Notification**
\
When blockchain transactions (such as USDT, ETH, etc.) are detected, we will send you notification messages through your Telegram bot.
Blockchain address monitoring api
#### Usage Steps
1. 1
**Apply for Bot**
* Open Telegram, search and add[【@BotFather】](https://t.me/BotFather)
* Enter command /newbot to start creating a new bot
* Follow the prompts to set the bot's name and username
* Record the generated bot token, which is crucial for subsequent binding
2. 2
**Bind Bot to Catfee**
* Login to Catfee.io personal center, selectBot Settingspage to input the bot token
* Click "Bind" button to complete bot binding
* After binding, energy selling bot is activated for free!
3. 3
**Configure Bot Notifications**
* Add the bot to the chat where you want to receive wallet monitoring change messages
* In Catfee.io personal center, select "Add Monitor Wallet"
* Enter the chat ID to ensure the bot can receive notifications correctly
4. 4
**Set Monitoring Parameters**
* On the monitor wallet page, select the blockchain type to listen to
* Enter the wallet address to monitor
* Select \[Telegram bot] type, set the blockchain type to monitor (BTC | ETH | TRON)
* Set chat ID, can choose channel, group or personal chat
**What is telegram chat ID?**
Chat ID is a unique numerical identifier for Telegram users, groups, or channels. Personal user chat IDs are positive integers (e.g., 8090000000), while group chat IDs are negative integers (e.g., -4980000000).
**How to get chat ID:**
1. Visit Telegram bot:[@CatFeeProBot](https://t.me/CatFeeProBot)
2. Send the command `"/tools"` to the bot
3. Select the chat ID query tool from the popup tool list
4. The bot will return the current chat ID, for example:
* User ID format:userID:8090000000 (where 8090000000 is the user chat ID)
* Group ID format:groupID:-4980000000 (where -4980000000 is the group chat ID)
Through these steps, you can easily implement real-time blockchain wallet monitoring, ensuring you don't miss any important balance changes.\
\
Blockchain address monitoring api or software chilk:
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.catfee.io/en/getting-started/blockchain-monitoring-service.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
