> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yativo.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Auto-Forwarding
> Automatically forward incoming deposits to a destination address based on configurable rules
Auto-Forwarding lets you create rules that automatically send incoming deposits from one wallet to another address. When crypto lands in a monitored wallet, the forwarding rule triggers and moves the funds to the destination — no manual intervention required.
Use cases: treasury sweeping, payment collection, fund aggregation, and automated payouts.
***
## How It Works
1. **Create a rule** — Specify the source asset, destination address, and forwarding conditions
2. **Deposits arrive** — When crypto is deposited to the source wallet, the rule evaluates
3. **Funds forward** — If the deposit matches the rule conditions, funds are automatically sent to the destination
***
## Create a Forwarding Rule
```bash theme={null}
curl -X POST 'https://crypto-api.yativo.com/api/v1/auto-forwarding' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"asset_id": "asset_01xyz789",
"destination_address": "0x9F8b3A2c1E4D7F6B5A4C3D2E1F0A9B8C7D6E5F4",
"destination_chain": "ethereum",
"min_amount": "10.00",
"enabled": true
}'
```
```json Response theme={null}
{
"success": true,
"data": {
"rule_id": "af_01abc123",
"asset_id": "asset_01xyz789",
"destination_address": "0x9F8b...",
"destination_chain": "ethereum",
"min_amount": "10.00",
"enabled": true,
"created_at": "2026-03-26T12:00:00Z"
}
}
```
***
## Rule Parameters
| Parameter | Type | Description |
| --------------------- | ------- | ------------------------------------------------------- |
| `asset_id` | string | The source wallet asset to monitor for deposits |
| `destination_address` | string | Where to forward funds |
| `destination_chain` | string | The chain of the destination address |
| `min_amount` | string | Minimum deposit amount to trigger forwarding (optional) |
| `enabled` | boolean | Whether the rule is active |
***
## List Rules
```bash theme={null}
curl -X GET 'https://crypto-api.yativo.com/api/v1/auto-forwarding' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
```
***
## Get Rule Details
```bash theme={null}
curl -X GET 'https://crypto-api.yativo.com/api/v1/auto-forwarding/af_01abc123' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
```
***
## Update a Rule
```bash theme={null}
curl -X PUT 'https://crypto-api.yativo.com/api/v1/auto-forwarding/af_01abc123' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"min_amount": "50.00",
"enabled": false
}'
```
***
## Delete a Rule
```bash theme={null}
curl -X DELETE 'https://crypto-api.yativo.com/api/v1/auto-forwarding/af_01abc123' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
```
***
## Trigger Manual Forward
Force an immediate forward for a rule, regardless of deposit conditions:
```bash theme={null}
curl -X POST 'https://crypto-api.yativo.com/api/v1/auto-forwarding/forward' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"rule_id": "af_01abc123"
}'
```
***
## Forwarding Thresholds
Yativo applies a minimum value threshold before executing a forward. This ensures the on-chain transfer cost is economical relative to the amount being moved.
### Per-wallet minimum (\$1 USD)
Deposits with an equivalent value below \*\*$1 USD** are not forwarded immediately. Instead they accumulate in the source wallet until the cumulative total reaches $1 USD, at which point the entire accumulated balance is forwarded in a single transaction.
This is automatic — no configuration is required. Your forwarding rule fires as normal; only the timing changes for sub-threshold deposits.
**Example:** A wallet receives three deposits of $0.30 USDC each. The first two are held. After the third, the total ($0.90) is still below $1 and remains accumulated. The next deposit that pushes the total to or past $1 triggers the forward for the full accumulated amount.
Your rule's `min_amount` field is evaluated against the transaction amount in token units and is separate from this USD threshold. Both conditions must be satisfied for a forward to execute.
### Cross-wallet batch (\$10 USD)
When you have **multiple wallets** accumulating small deposits, forwarding efficiency is improved further by batching across wallets. Once the combined accumulated balance across **all** of your wallets for the same network and token reaches **\$10 USD**, all pending wallets are forwarded together in a single batch — sharing one on-chain gas cost.
This means deposits can forward earlier than the per-wallet $1 threshold if the cross-wallet cumulative total reaches $10 first.
**Example:** You have five wallets, each holding $2 USDC in accumulated deposits ($10 total). When the fifth wallet's deposit brings the cross-wallet total to \$10, all five wallets forward simultaneously in one batch.
### Threshold summary
| Condition | Behaviour |
| ---------------------------------------- | ------------------------------------------------------- |
| Deposit ≥ \$1 USD | Forward executes immediately per your rule |
| Deposit \< $1 USD, wallet total < $1 USD | Accumulated — held until wallet total ≥ \$1 USD |
| Wallet total ≥ \$1 USD | Single-wallet batch forward triggered |
| Cross-wallet total ≥ \$10 USD | All wallets with pending accumulations forward together |
***
## Webhook Events
| Event | Trigger |
| --------------------------- | ------------------------------------------------ |
| `auto_forwarding.triggered` | A forwarding rule was triggered by a deposit |
| `auto_forwarding.completed` | The forwarded transaction was confirmed on-chain |
| `auto_forwarding.failed` | The forwarding transaction failed |
***
## Next Steps
Full endpoint reference for auto-forwarding.
Set up notifications for forwarding events.
View forwarded transactions in your transaction history.