> For the complete documentation index, see [llms.txt](https://help.keyring.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.keyring.app/keyring-one/features/auto-swap-and-distribution-setting.md).

# Auto Swap and Distribution Setting

## What Are Auto Swap & Distribution Settings? <a href="#what-are-auto-swap-and-distribution-settings" id="what-are-auto-swap-and-distribution-settings"></a>

Auto Swap & Distribution Settings allow organizations to automatically convert incoming USDC or USDT revenue into another supported token before distributing it.

At each scheduled distribution time, the smart contract swaps the entire available balance of the selected USDC or USDT into the chosen destination token. The resulting tokens are then sent either to the connected operation address or distributed among multiple recipient addresses according to the configured percentages.

This feature follows the same distribution rules as Distribution Settings, with an additional automatic swap step.

## How to Set Up Auto Swap & Distribution Settings <a href="#how-to-set-up-auto-swap-and-distribution-settings" id="how-to-set-up-auto-swap-and-distribution-settings"></a>

Auto Swap & Distribution Settings automatically swap incoming USDC or USDT revenue into a selected token and distribute the resulting tokens according to the configured recipient option and schedule.

1. Go to the **Auto Swap & Distribution Settings** tab.
2. Under **Supported Assets**, select USDC or USDT.
3. Under **Swap To**, select the token you want to receive after the swap.
4. Under **Recipient**, select one of the following:
   * **Your Current Address**
   * **Forwarding Address and Ratio**
5. When selecting **Forwarding Address and Ratio**, enter the recipient wallet addresses and distribution percentage for each address.
6. To add another recipient, select **Add More**. You can add up to 12 recipient addresses.
7. Set the **Distribution Time**.
8. Review the applicable distribution fee.
9. Select **Set Up**.
10. Approve the required requests in KEYRING PRO Wallet.
11. Wait for the setup process to complete.

<figure><img src="/files/5QKS7i3ZA10wQc3AoV1O" alt=""><figcaption></figcaption></figure>

## Recipient Options <a href="#recipient-options" id="recipient-options"></a>

Only one recipient option can be selected for each Auto Swap & Distribution contract.

### Your Current Address <a href="#your-current-address" id="your-current-address"></a>

Select **Your Current Address** to send the entire swapped amount back to the wallet address currently connected to KEYRING ONE.

When this option is selected:

* The connected operation address is the only recipient.
* No additional recipient addresses can be added.
* The distribution fee is calculated as one recipient.

### Forwarding Address and Ratio <a href="#forwarding-address-and-ratio" id="forwarding-address-and-ratio"></a>

Select **Forwarding Address and Ratio** to distribute the swapped tokens among multiple wallet addresses.

The following rules apply:

* The total distribution percentage across all recipient addresses must equal 100%.
* The connected operation address cannot be added as a forwarding address.
* A maximum of 12 recipient addresses can be added.
* The distribution fee is calculated based on the number of recipient addresses.

## Supported Source Assets <a href="#supported-source-assets" id="supported-source-assets"></a>

Auto Swap & Distribution Settings currently support the following source stablecoins:

* USDC
* USDT

At each scheduled distribution time, the entire available balance of the selected source stablecoin is swapped and distributed.

Only one active distribution-related contract can exist for each supported stablecoin across both **Distribution Settings** and **Auto Swap & Distribution Settings**.

For example:

* If a USDC contract is active under Distribution Settings, another USDC contract cannot be created under Auto Swap & Distribution Settings.
* If a USDT Auto Swap & Distribution contract is active, another USDT distribution contract cannot be created until the current contract is stopped.

This rule applies because each contract processes the entire available balance of its selected USDC or USDT.

## Distribution Time <a href="#distribution-time" id="distribution-time"></a>

You can choose between two automatic distribution schedules.

### Hourly <a href="#hourly" id="hourly"></a>

Revenue is swapped and distributed once every hour, starting from the next full hour after the setup is completed.

For example:

* If the setup is completed at 4:20, the first execution is scheduled for 5:00.
* If the setup is completed at 4:45, the first execution is also scheduled for 5:00.

After the first execution, the system continues processing every hour.

### Daily <a href="#daily" id="daily"></a>

Revenue is swapped and distributed once per day at the selected UTC hour.

Only full-hour times can be selected. Minutes cannot be configured.

For example, selecting 12:00 UTC means the system will attempt to swap and distribute the available revenue every day at 12:00 UTC.

## Distribution Fee <a href="#distribution-fee" id="distribution-fee"></a>

A distribution fee is charged each time the system successfully completes an Auto Swap & Distribution.

The fee is calculated based on the number of recipient addresses:

* **Most supported networks:** USD 0.10 per recipient address
* **Ethereum:** USD 2.00 per recipient address

When **Your Current Address** is selected, the fee is calculated for one recipient:

* USD 0.10 on most supported networks
* USD 2.00 on Ethereum

When **Forwarding Address and Ratio** is selected, the fee is calculated according to the number of forwarding addresses.

For example, distributing to three addresses would incur:

* USD 0.30 on most supported networks
* USD 6.00 on Ethereum

The fee is deducted automatically when the transaction is successfully processed.

## How to Stop an Auto Swap & Distribution Contract <a href="#how-to-stop-an-auto-swap-and-distribution-contract" id="how-to-stop-an-auto-swap-and-distribution-contract"></a>

Only one active distribution-related contract can exist for each supported stablecoin, and the settings of an existing contract cannot be changed.

To update the destination token, recipient option, recipient addresses, percentages, or schedule, you must stop the current contract and create a new one.

To stop an Auto Swap & Distribution contract:

1. Go to the **Auto Swap & Distribution Settings** tab.
2. In the panel on the right, open **My Auto Swap & Distribution Settings**.
3. Select the contract you want to stop.
4. Select **Stop Distribution**.
5. Confirm the request in KEYRING PRO Wallet.
6. Wait for the process to complete.

<figure><img src="/files/N8u8CGmNJIIFJbJD6kOe" alt=""><figcaption></figcaption></figure>

#### Important Notes

* Stopping the contract permanently removes the current Auto Swap & Distribution settings.
* The contract settings cannot be restored after the contract has been stopped.
* To resume the service for the same USDC or USDT, you must create a new contract.
* The new contract can use a different destination token, recipient option, forwarding addresses, percentages, or schedule.