dca-bot

Automates scheduled dollar-cost-average token purchases through the Uniswap Trading API.

1|Updated Sep 4, 2025
One-click install
npx skills add https://github.com/FuzzysTodd/The-Nexus-Protocol-Token-DAO --skill dca-bot-fuzzystodd
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dca-bot
Source: https://github.com/FuzzysTodd/The-Nexus-Protocol-Token-DAO/tree/main/skills/dca-bot
Command: npx skills add https://github.com/FuzzysTodd/The-Nexus-Protocol-Token-DAO --skill dca-bot-fuzzystodd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually buying a token on a recurring schedule is error-prone and easy to forget, and automating it safely requires idempotency, spend limits, and condition checks. This Skill runs a self-contained DCA execution on each scheduler wake, buying a fixed amount into a token only when cadence, conditions, and guardrails allow. ## Core Features & Use Cases - Scheduled recurring buys: Executes one idempotent buy per period (for example daily), skipping safely if a buy already happened in the current period. - Conditional purchases: Optionally buys only when a price condition holds, such as only when ETH is below a configured threshold, using Uniswap Trading API quotes as the price source. - Guardrails and execution modes: Enforces per-run and per-period spend caps, token allowlists, and a kill switch, with a default confirm mode and an autonomous mode that requires all guardrails. - Use Case: Configure a daily buy of 50 USDC into ETH, gated on ETH trading below 3000 USDC; the host scheduler wakes the Skill each day, and it checks state, evaluates the condition, confirms with you, and delegates the swap to swap-integration. ## Quick Start Ask the agent to set up a daily DCA of a fixed USDC amount into ETH on your target chain, only buying when the price is below your chosen threshold.

Frequently Asked Questions about dca-bot

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a recurring crypto buy or DCA into a token?▼

Configure the target token, fixed buy amount, and cadence, then let the host agent's scheduler invoke the Skill each period. Each wake reads the state file, checks whether a buy already happened this period, and delegates the swap to the Uniswap Trading API flow.

How do I buy ETH only when the price drops below a threshold?▼

Configure a price condition such as buying only when ETH is below a set USDC value. The Skill fetches the current price from the Trading API quote endpoint, evaluates the predicate, and skips the buy if the condition is not met.

Does the DCA bot execute swaps itself or use Uniswap?▼

All execution goes through the Uniswap Trading API via the swap-integration and viem-integration prerequisites. The Skill never builds its own quote, approval, swap, or signing logic; it only supplies parameters like tokenIn, tokenOut, amount, and chain id.

Can the DCA bot run autonomously without confirming each transaction?▼

Yes, but autonomous mode requires a per-run and per-period spend cap, a token allowlist, a dry run first, and a kill switch. Without all four, the Skill falls back to confirm mode, which asks for approval before each broadcast.

What happens if the bot wakes up twice in the same period?▼

The Skill is idempotent: it records the last buy period in a JSON state file and skips any wake where a successful buy is already recorded for the current period. This prevents double buys from repeated scheduler invocations.

Why did my scheduled buy get skipped?▼

Buys are skipped when the price condition is unmet, a guardrail blocks the spend, the wallet lacks funding tokens or gas, or a buy already occurred this period. Skips are recorded in the state file and reported as normal outcomes, not errors.