Run a DCA plan, step by step

From test tokens to a running plan that never pays the trend spread, in the app, from TypeScript, over HTTP or by asking Claude. Every step shows all four.

  1. You create the orderApprove the exact budget, then createOrder escrows it.
  2. PoincareDCA holds itBudget, schedule and protection, on chain.
  3. A keeper calls each slotEvery interval it asks: can the next slice fill?
  4. The rules decideSpread cap, trend pause, limit price. Held, or filled.
  5. Filled at the poolQuoted and swapped atomically; WETH to you.
Your budget sits in PoincareDCA, not with the keeper. The keeper can only fill a slice the contract's rules allow, re-checked in the same transaction, and the output goes straight to your wallet.

Before you start

Poincaré runs on Unichain Sepolia, a testnet: the tokens are free and carry no value. You need a wallet on chain 1301 with some test USDC (to buy WETH) or test WETH (to sell it), plus a little Sepolia ETH for gas.

The steps

  1. 1
    Get test tokens. One claim gives 50,000 USDC and 20 WETH.
    Launch app → connect your wallet
    → "Get test tokens" (in the footer, or on the Trade ticket when your balance is empty)
  2. 2
    Decide the plan. A recurring plan buys a fixed amount on a schedule; a TWAP spreads one total over a window. Both become the same on-chain order: a budget, a number of slices and an interval.
    You wantPlanOrder
    100 USDC of WETH every hour, 8 timesRecurringamount 800, slices 8, interval 3600
    Sell 2 WETH evenly over 4 hoursTWAPamount 2, slices 4, interval 3600
  3. 3
    Choose the protection. The spread guard (the default) never pays the trend spread: a slice that would pay it waits, and catch-up grows the later ones so the plan still finishes on time. This is what it looks like:
    Calm · no spreadUp-trend · buys payTrend over · no spread01001501001h1002hheld3hheld4h1505h1506h1507h1508hcatch-up: 600 left ÷ 4 slots = 150spread guard holds
    Spread guard with catch-up, on a plan of 8 hourly buys of 100 USDC. A trend makes buys pay the spread in hours 3 and 4, so those buys wait. The 600 USDC still to spend is then split over the 4 hours left, 150 each: the plan pays no spread and still finishes on time.

    The other presets, and every field, are on Spread-aware DCA.

  4. 4
    Create it. Two signatures: an approval of exactly the budget (never unlimited), then createOrder, which escrows it.
    Trade → DCA tab → Buy
    → Plan type: Recurring → Each buy 100 USDC → Hourly → 8 buys
    → Protection: Spread guard → Review plan
    → Confirm & start plan (approve, then create)
  5. 5
    Watch it fill. A keeper submits each slice when it is due. A held slice is not lost: it waits for the spread to clear and is made up later.
    Dashboard → Your activity → DCA, or the DCA panel beside the Trade ticket.
    Each fill also appears in your Trades history, tagged "DCA #id · free".
  6. 6
    Adjust or stop it. Pause and resume at will; edit re-plans what is left from now; cancel refunds the rest at once.
    In the DCA list:
    Pause / Resume
    Edit (number of buys, frequency, protection)
    Cancel (asks you to confirm first)
Ask Claude. With the Poincaré skill installed, Claude plans the order, checks it like the contract and explains every held slice in plain words.

Unichain Sepolia · chain 1301 · testnetLaunch app