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

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
  }'

Response

{
  "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

curl -X GET 'https://crypto-api.yativo.com/api/v1/auto-forwarding' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

---

Get Rule Details

curl -X GET 'https://crypto-api.yativo.com/api/v1/auto-forwarding/af_01abc123' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

---

Update a Rule

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

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:

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

API Reference

Full endpoint reference for auto-forwarding.

Webhooks

Set up notifications for forwarding events.

Transactions

View forwarded transactions in your transaction history.