Vauban Docs
Guides

DCA Intents

DCA Intent Guide

Set up automated dollar-cost averaging (DCA) strategies that execute via the AVNU aggregator.

What is DCA?

Dollar-Cost Averaging spreads a purchase across multiple time periods, reducing the impact of price volatility.

Example: Instead of buying 100 STRK at once, buy 10 STRK every day for 10 days.

Creating a DCA Intent

  1. Navigate to the DCA section
  2. Configure your intent:
ParameterDescriptionOptions
Intent TypeDirection of the swapDCA_IN, DCA_OUT, REBALANCE
Input TokenToken you're spendingAny supported token
Output TokenToken you're buyingAny supported token
Total AmountTotal to spend over the durationWei amount
FrequencyHow often to executeHOURLY, DAILY, WEEKLY
DurationHow long the DCA runs1-365 days
  1. Set optional parameters:

    • Max Slippage (1-5000 bps): Maximum acceptable slippage per swap
    • Price Bounds: Min/max price to execute (skip execution if outside bounds)
    • Auto-Stake: Automatically stake output tokens in a vault
  2. Sign the intent with your wallet

  3. The executor automatically swaps at each interval

Managing Intents

ActionDescription
PauseTemporarily stop executions
ResumeRestart a paused intent
CancelPermanently stop the intent
UpdateChange slippage or price bounds

Execution Details

  • Swaps route through AVNU aggregator for best execution
  • Each execution uses amountPerExecution = totalAmount / totalExecutions
  • Executions are skipped if price is outside configured bounds
  • Failed executions are retried on the next cycle
  • The executor runs as a backend cron job (configurable interval)

Monitoring

View your intents on the DCA page:

  • Status: Active, Paused, Completed, Cancelled, Failed
  • Progress: Executions completed vs total
  • Execution History: Each swap with price, amount, and transaction hash
  • Next Execution: Countdown to next scheduled swap

Execution Modes

ModeDescription
ProductionReal on-chain swaps via executor wallet
SimulationDry run (no on-chain txs) when executor keys not configured

Set EXECUTOR_PRIVATE_KEY and EXECUTOR_ADDRESS in environment to enable production mode.