CatFee.IO
English
English
  • Introduction
  • Getting started
    • Quick Start Guide
    • Buy Energy via Direct TRX Transfer
    • Buy Energy via DApp
    • Buy Energy via API
      • API Overview
      • Java Example for Calling API
      • Python Example for Calling API
      • PHP Example for Calling API
      • Node.js Example for Calling API
      • Go Example for Calling API
    • API Supports Idempotency
    • Energy Subleasing Service
    • 💎Telegram Premium Reselling
    • Blockchain Monitoring Service
    • TRON Node Connection Guide
    • Frequently Asked Questions (FAQ)
    • Terms of Service
  • API Reference
    • Account Information
    • Buy Energy
    • Get Order Detail
    • Estimated Order Amount
    • Buy Telegram Premium
  • knowledge base
    • What is TRON Energy?
    • Why Rent Energy on the TRON Network?
    • How to fix “OUT OF ENERGY” error on TRON Transfers?
    • Why Can’t You Use a Centralized Exchange (CEX) Wallet to Buy TRON Energy?
    • What is a Centralized Exchange (CEX)?
    • How Much Energy and Bandwidth Does a USDT Transfer Consume?
    • Why Does the Transfer Fail Even After Renting Energy on TRON?
    • Why Are Some Energy Rentals So Cheap?
  • Telegram Bot
    • How to Create a Telegram Bot and Host It on CatFee?
Powered by GitBook
On this page

Was this helpful?

  1. Getting started

Blockchain Monitoring Service

🔍 CatFee Blockchain Monitoring Service 📊 CatFee Blockchain Monitoring Service helps users track real-time blockchain data changes, such as transactions, balances, and blocks.

PreviousTelegram Premium ResellingNextTRON Node Connection Guide

Last updated 10 days ago

Was this helpful?

🔗 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.

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": "0x1a2b3c4d5e...",  // Transaction hash
    "block_id": 123456789,      // Block number
    "address": "0xABC123...",   // Monitored address
    "from_address": "0xDEF456...", // From address
    "to_address": "0xJKL012...",  // To address
    "contract_address": "0xGHI789...", // Contract address
    "amount": 1000000,          // Original amount
    "decimals": 6,              // Amount decimals
    "currency": "USDT",         // Currency
    "chain": "ETH",             // Chain
    "paid_at": 1684789012,      // Transaction timestamp
    "notify_type": "BLOCK_AMOUNT_CHANGE" // Notification type
  }

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.

Usage Steps

  1. 1

    Apply for Bot

    • 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. Send the command "/tools" to the bot

  2. Select the chat ID query tool from the popup tool list

  3. 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)

Open Telegram, search and add

Visit Telegram bot:

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:

【@BotFather】
@CatFeeProBot
https://catfee.io/blockchain/monitoring/
Blockchain Monitoring api
Blockchain address monitoring api