Skip to main content
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

ParameterTypeDescription
asset_idstringThe source wallet asset to monitor for deposits
destination_addressstringWhere to forward funds
destination_chainstringThe chain of the destination address
min_amountstringMinimum deposit amount to trigger forwarding (optional)
enabledbooleanWhether 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 **1USD∗∗arenotforwardedimmediately.Insteadtheyaccumulateinthesourcewalletuntilthecumulativetotalreaches1 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.30USDCeach.Thefirsttwoareheld.Afterthethird,thetotal(0.30 USDC each. The first two are held. After the third, the total (0.90) is still below 1andremainsaccumulated.Thenextdepositthatpushesthetotaltoorpast1 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 1thresholdifthecross−walletcumulativetotalreaches1 threshold if the cross-wallet cumulative total reaches 10 first. Example: You have five wallets, each holding 2USDCinaccumulateddeposits(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

ConditionBehaviour
Deposit ≥ $1 USDForward executes immediately per your rule
Deposit < 1USD,wallettotal<1 USD, wallet total < 1 USDAccumulated — held until wallet total ≥ $1 USD
Wallet total ≥ $1 USDSingle-wallet batch forward triggered
Cross-wallet total ≥ $10 USDAll wallets with pending accumulations forward together

​
Webhook Events

EventTrigger
auto_forwarding.triggeredA forwarding rule was triggered by a deposit
auto_forwarding.completedThe forwarded transaction was confirmed on-chain
auto_forwarding.failedThe 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.