Sweep Assist

Sweep Assist 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. Sweep Assist 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.

CatFee monitors addresses, tops up energy, and sends notifications. You complete asset collection using your own wallet or script.

Who Should Use It

Sweep Assist 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. Sweep Assist 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. Sweep Assist 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. Sweep Assist 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.

• Webhook notifications: Notify your business system after the energy delegation is confirmed on-chain, so you can continue your collection script or notify customers.

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

To automate the next step, subscribe to the EVENT_DELEGATION event and receive a Webhook notification after the energy delegation is confirmed on-chain.

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.

Webhook Top-Up Notifications

After Sweep Assist delegates energy to a target address and the delegation is confirmed on-chain, CatFee can send an EVENT_DELEGATION (Delegation Confirmed) event to your configured callback URL via HTTP POST. Your business system can use this notification to tell customers that energy has arrived or continue an existing USDT collection script.

Setup and Processing Flow

1. Go to User Center → API Settings, enter your callbackUrl, and subscribe to EVENT_DELEGATION. HTTP and HTTPS callback URLs are supported. Subscriptions must be configured on this page; dynamic subscription through the API is not supported.

2. Receive the JSON callback and identify EVENT_DELEGATION using the X-EVENT-TYPE request header. Check that data.business_type is BUSINESS_SWEEP_ASSISTANT and data.resource_type is ENERGY to identify Sweep Assist energy delegation notifications. For older notifications, also accept the previous business name BUSINESS_REALTIME_COLLECTION. If the business type is missing or unknown, follow the compatibility guidance in the Webhook documentation linked below.

3. Use data.receiver to match a receiving address you manage and its customer. Check your pending collection records before notifying the customer or starting the next collection step.

4. Use X-EVENT-ID as an idempotency key to avoid duplicate customer notifications or collection attempts. Return HTTP 200 after successfully receiving and processing the event. Return 200 for events already processed as well; otherwise, the platform will retry the notification.

Key Callback Fields

The following fields appear in the request body's data object:

Field	Description
resource_type	Resource type: ENERGY for energy or BANDWIDTH for bandwidth
business_type	BUSINESS_SWEEP_ASSISTANT for Sweep Assist; the name before event protocol 20260930 was BUSINESS_REALTIME_COLLECTION
receiver	Address receiving the energy, used to identify the receiving address and customer
quantity	Amount of resources delegated
delegation_hash	Delegation transaction hash, used to verify the on-chain transaction
delegation_timestamp	Delegation time

EVENT_DELEGATION confirms that an energy or bandwidth delegation is on-chain. It does not mean that USDT collection is complete. Your wallet, script, or business system still initiates the asset transfer.

See the Webhook documentation for the complete event structure, field definitions, request headers, and retry policy.

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

Sweep Assist 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

Sweep Assist 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 Sweep Assist?

Sweep Assist 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. Sweep Assist 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. Sweep Assist 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. Sweep Assist 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 Sweep Assist 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.