> 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/en/getting-started/real-time-collection.md). # Real-Time Collection Real-Time Collection is CatFee's automated energy top-up service for TRON multi-address collection, USDT consolidation, and hot wallet operations. When your receiving addresses meet the collection conditions, CatFee tops up TRON Energy for the target addresses based on your predefined rules, helping your USDT transfer or collection scripts run more reliably. Real-Time Collection only provides energy top-ups. It does not access private keys, does not custody wallets, and does not transfer USDT, TRX, or any other assets on your behalf. ## Who Should Use It Real-Time Collection is designed for users who manage multiple TRON receiving addresses and want to reduce the operational cost of manual energy top-ups, constant monitoring, and failed collections. **Merchant Collection** Suitable for multi-address collection scenarios such as e-commerce, payment teams, and OTC merchants. After multiple receiving addresses gradually receive USDT, the system can automatically top up energy once the collection threshold is reached, reducing delays caused by manual energy checks and manual top-ups. **Wallet and Exchange Operations** Suitable for wallets, exchanges, and treasury operations teams. Hot wallet management, deposit address handling, and internal address pool collection often require stable execution. Real-Time Collection helps operations teams retain top-up records, fee records, and failure statuses for later reconciliation. **DApps and On-Chain Tools** Suitable for developers building payment tools, on-chain tools, and internal systems. When business addresses do not maintain stable energy availability, user transfers may fail, and building an in-house monitoring and top-up system increases development and maintenance costs. Real-Time Collection can serve as the address monitoring and energy execution layer, reducing integration complexity. **High-Frequency Small-Value Receipts** Suitable for individuals or small teams managing a large number of small-value receiving addresses. When the number of addresses grows, checking balances and energy status one by one becomes inefficient. Rule-based energy top-ups reduce repetitive operational work. > **Already have your own collection script?** > > In most cases, no major changes are required. Real-Time Collection can sit in front of your existing collection workflow as an energy assurance layer: CatFee handles the energy top-up when a rule is triggered, while the actual collection transfer is still initiated by your wallet, script, or business system. ## Core Capabilities * **Rule-based monitoring**: Configure trigger conditions by address pool, such as a USDT balance reaching a specified threshold. * **Batch address management**: Manage multiple receiving addresses under one rule and add or remove addresses later as needed. * **Automatic energy top-up**: Top up TRON Energy for target addresses after a rule is triggered, reducing the risk of failed USDT transfers caused by insufficient energy. * **Budget control**: Control costs through rule enablement, per-top-up energy amount, and budget limits. * **Execution records**: Each top-up generates a record with the target address, energy amount, fee details, and execution status for operational review and financial reconciliation. * **Non-custodial design**: No private keys required, no wallet control, and no asset transfers on your behalf. ## Workflow ### 1. Create a Collection Energy Rule Create a collection energy top-up rule in the CatFee Dashboard. First configure the base rule, then add the receiving addresses you want to monitor. Common settings include: * **Balance Threshold**: The system triggers a top-up when the monitored address has a USDT balance greater than or equal to this threshold. For example, setting it to `10` means the top-up is triggered once the address balance reaches 10 USDT. * **Energy Quantity**: The amount of energy to top up each time the rule is triggered. The minimum is 65,000 Energy, and you can configure it based on your collection transfer requirements. * **Bandwidth Protection**: When enabled, the system reserves bandwidth to reduce the risk of a failed collection transfer caused by insufficient bandwidth. * **Remark**: A label for the rule's purpose, such as primary wallet collection, merchant address pool, or a specific business line. After creating the rule, you still need to add the monitored addresses. If a newly added address has not been activated yet, the system will activate it automatically and charge the address activation fee shown in the Dashboard. ### 2. Import Receiving Addresses Import the TRON receiving addresses you want to monitor into the rule. Addresses can be grouped by business line, merchant, wallet address pool, or collection batch. After import, the system continuously checks the status of these addresses. You can also add, remove, or adjust addresses as your business changes. ### 3. Continuous Monitoring After the rule is enabled, CatFee continuously checks whether an address meets the trigger conditions. For example: * The address USDT balance reaches 30 USDT, 100 USDT, or another custom threshold. * The address enters an operational state that requires collection. * A specific address in the pool matches the top-up rule. At present, the primary trigger condition is address balance. Additional trigger methods, such as scheduled triggers, manual triggers, or combined rules, depend on the actual capabilities available in the Dashboard. ### 4. Automatic Top-Up After a Rule Match When an address meets the conditions, the system tops up TRON Energy according to the rule. After a rule is triggered, the top-up is typically executed within one TRON block, which is usually around 3 seconds. Once the top-up is complete, your collection script, wallet operations, or internal system can proceed with the USDT collection transfer. ### 5. Review Records and Fees Each top-up generates an execution record that typically includes: * Execution time * Target address * Energy amount * Top-up fee * Transaction hash or execution status * Result details such as success, failure, or insufficient balance No top-up order is created before a rule is triggered. Failed top-ups are not billed, and the failure status remains in the records for troubleshooting balances, rules, addresses, or network conditions. ## Configuration Examples The examples below are for reference only. Actual configuration options and pricing are subject to what is shown in the CatFee Dashboard. | Scenario | Trigger Condition | Top-Up Strategy | Address Scope | Balance Requirement | | --------------------- | -------------------------------------------------- | ------------------------------------------- | -------------- | ------------------------------------------------ | | Small-value receipts | USDT balance >= 30 | Custom energy amount, minimum 65,000 Energy | 32 addresses | Ensure the CatFee account has sufficient balance | | Merchant collection | USDT balance >= 100 | Custom energy amount, minimum 65,000 Energy | 128 addresses | Ensure the CatFee account has sufficient balance | | Hot wallet operations | Business balance reaches the operational threshold | Custom energy amount, minimum 65,000 Energy | 500+ addresses | Ensure the CatFee account has sufficient balance | ## Fees and Controls Real-Time Collection is billed based on successful energy top-up executions. No top-up order is created before a rule is triggered, and no new top-up orders are generated while a rule is paused. You can control costs in the following ways: * **Pause rules**: Pause a rule directly when operations change, a campaign ends, or budgets tighten. * **Control the top-up amount per execution**: Choose an appropriate energy amount based on the transfer type and avoid over-provisioning. * **Review execution records**: Reconcile costs using the target address, energy amount, and fee details. * **Monitor account balance**: When your account balance is insufficient, the Dashboard displays a low-balance warning. Recharge in time to avoid interrupting the collection workflow. ## Security Boundaries Real-Time Collection only handles energy preparation. It does not perform asset collection itself. | Boundary | Description | | -------------------------------- | ---------------------------------------------------------------------------------------------------------------- | | No private key required | CatFee does not ask users to submit private keys and does not require wallet custody | | No asset transfer on your behalf | CatFee only tops up TRON Energy and does not initiate transfers of USDT, TRX, or any other assets for users | | User retains control | Users can pause, modify, or delete rules at any time, and can also adjust the address list and top-up strategy | | Auditable records | Top-up results and fee details can be used for operational review, financial reconciliation, and troubleshooting | ## Operational Recommendations 1. Organize the receiving addresses you need to monitor and group them by business line or use case. 2. Set USDT balance thresholds based on your collection strategy. For example, use a lower threshold for small-value receipts and a higher threshold for merchant collection. 3. Choose the energy amount based on the target transfer type, such as 65,000 Energy or 131,000 Energy. 4. Set budget limits and balance alerts to avoid failed top-ups caused by insufficient account balance. 5. Start with a small set of addresses to validate the rule, then gradually expand to the full address pool. 6. Export or review execution records regularly for operational analysis and cost reconciliation. ## FAQ ### What is TRON Real-Time Collection? TRON Real-Time Collection is CatFee's automated energy top-up capability for multi-address USDT collection and fund consolidation scenarios. After users configure monitored addresses, balance thresholds, and top-up rules, the system tops up TRON Energy for target addresses when the collection conditions are met, reducing the risk of failed or interrupted USDT transfers caused by insufficient energy. ### Does CatFee control my wallet? No. Real-Time Collection is a non-custodial service. It does not require private keys and does not control wallet permissions. CatFee only tops up TRON Energy for the target address when a rule is triggered. ### Will CatFee automatically collect my USDT after the energy top-up? No. Real-Time Collection only solves the TRON Energy preparation step. It does not move assets. After the top-up is completed, the USDT collection transfer is still initiated by your wallet operations, collection script, or internal system. ### Under what conditions is energy topped up automatically? Energy is topped up automatically when a configured TRON address meets the trigger conditions, such as reaching a specified USDT collection threshold. You can configure the monitoring conditions and top-up strategy in the Dashboard. ### How long does the top-up take? After a rule is triggered, the system typically executes the top-up within one TRON block, usually about 3 seconds. Once the energy arrives, your USDT collection script or transfer workflow can continue. ### What happens if the top-up fails? If an automatic top-up fails, the system records the failure status and shows the execution result in the Dashboard, making it easier to troubleshoot address issues, balances, rules, or network conditions. Failed top-ups are not billed. ### Does it support batch address import? Yes. Real-Time Collection is suitable for merchants, wallets, and exchanges that manage a large number of TRON receiving addresses. You can batch import an address list through the Dashboard and apply a unified top-up rule. ### Can I modify or delete a rule at any time? Yes. You can pause, modify, or delete a collection energy rule at any time. You can also adjust the address list, USDT balance threshold, and top-up amount. When a rule is paused, no new top-up orders are created. ### I already have a collection script. Do I still need to modify it? Usually not. CatFee Real-Time Collection can act as an energy assurance layer in front of your existing USDT collection workflow. After the energy top-up is completed, the collection can continue through your original script, wallet, or internal system. If you need API integration, contact CatFee technical support to confirm the implementation approach. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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/real-time-collection.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.