AGENT SKILL

dca

Create, preview, list, and cancel recurring Dollar-Cost Averaging (DCA) buy orders on Starknet via AVNU or Ekubo. Use this skill when the user wants to set up automatic recurring purchases, dollar-cost average into a token, create a DCA order, schedule periodic buys, invest regularly, buy every day/week/month, or manage existing DCA orders. Also trigger when the user says "recurring buy", "scheduled purchase", "buy X of Y every day", or any variation about automated periodic investing — even if they don't use the term "DCA" explicitly.

License 许可
MIT
最近更新
2026-11-15
Stars
★ 81
Forks
17

01 前言 Front Matter

name
dca
license
MIT
metadata
{ "author": "ahmetenesdur", "version": "0.1.0", "category": "transaction" }
description
Create, preview, list, and cancel recurring Dollar-Cost Averaging (DCA) buy orders on Starknet via AVNU or Ekubo. Use this skill when the user wants to set up automatic recurring purchases, dollar-cost average into a token, create a DCA order, schedule periodic buys, invest regularly, buy every day/week/month, or manage existing DCA orders. Also trigger when the user says "recurring buy", "scheduled purchase", "buy X of Y every day", or any variation about automated periodic investing — even if they don't use the term "DCA" explicitly.
allowed-tools
[ "Bash(npx starkfi@latest dca-create *)", "Bash(npx starkfi@latest dca-list)", "Bash(npx starkfi@latest dca-list *)", "Bash(npx starkfi@latest dca-cancel *)", "Bash(npx starkfi@latest dca-preview *)", "Bash(npx starkfi@latest status)", "Bash(npx starkfi@latest balance)", "Bash(npx starkfi@latest balance *)", "Bash(npx starkfi@latest tx-status *)" ]
compatibility
Requires Node.js 22+ and npx.

02 资源文件 3

03 SKILL.md 正文

Dollar-Cost Averaging (DCA)

Create recurring buy orders that automatically swap a fixed amount of one token into another at regular intervals. Supports AVNU and Ekubo DCA providers.

Prerequisites

  • Active session required.
  • Sufficient balance of the sell token for the total DCA amount.
  • Account must be deployed on-chain.

Rules

  1. BEFORE any DCA operation, you MUST run npx starkfi@latest status and npx starkfi@latest balance to verify connectivity and funds.
  2. ALWAYS run dca-preview before dca-create to verify the expected output per cycle.
  3. The --per-cycle flag is required for dca-create. It sets the amount sold each execution cycle.
  4. Frequency uses ISO 8601 duration format: P1D (daily), PT12H (12 hours), P1W (weekly).
  5. Suggest using --simulate first to verify the DCA order would succeed.
  6. AFTER a successful creation, verify with npx starkfi@latest tx-status <hash>.

Commands

Preview a Cycle

npx starkfi@latest dca-preview <amount> <sell_token> <buy_token> [--provider <avnu|ekubo>] [--json]

Create a DCA Order

npx starkfi@latest dca-create <total_amount> <sell_token> <buy_token> \
  --per-cycle <amount> \
  [--frequency <duration>] \
  [--provider <avnu|ekubo>] \
  [--simulate] [--json]

List DCA Orders

npx starkfi@latest dca-list [--status <ACTIVE|CLOSED|INDEXING>] [--provider <avnu|ekubo>] [--page <n>] [--json]

Cancel a DCA Order

npx starkfi@latest dca-cancel <order_id_or_address> [--provider <avnu|ekubo>] [--json]

Parameters

Parameter Type Description Required
amount string Total sell amount (create) or per-cycle amount (preview) Yes
sell_token string Token to sell (e.g. STRK, ETH) Yes
buy_token string Token to buy (e.g. USDC, ETH) Yes
order_id_or_address string The UUID OR on-chain contract address (0x...) from dca-list Yes (cancel)
--per-cycle string Amount to sell per cycle Yes (create)
--frequency string ISO 8601 duration (default: P1D=daily) No
--provider string DCA provider: avnu (default) or ekubo No
--status string Filter orders: ACTIVE, CLOSED, INDEXING No (list)
--simulate flag Estimate fees without broadcasting No
--json flag Output as JSON No

Examples

User: "Buy 10 USDC worth of ETH every day for 100 days"

npx starkfi@latest status
npx starkfi@latest balance
npx starkfi@latest dca-preview 10 USDC ETH
npx starkfi@latest dca-create 1000 USDC ETH --per-cycle 10 --frequency P1D --simulate
npx starkfi@latest dca-create 1000 USDC ETH --per-cycle 10 --frequency P1D
npx starkfi@latest tx-status <hash>

User: "DCA into STRK weekly with 50 USDC per week, total 200 USDC"

npx starkfi@latest status
npx starkfi@latest balance
npx starkfi@latest dca-preview 50 USDC STRK
npx starkfi@latest dca-create 200 USDC STRK --per-cycle 50 --frequency P1W

User: "Show my active DCA orders"

npx starkfi@latest dca-list --status ACTIVE --json

User: "Cancel my DCA order"

npx starkfi@latest dca-list --status ACTIVE
npx starkfi@latest dca-cancel <order_id_or_address>
npx starkfi@latest tx-status <hash>

Error Handling

Error Action
DCA_FAILED Check the error message for details (balance, provider).
Insufficient balance Check balance for the sell token.
Not authenticated Run authenticate-wallet skill first.
Invalid frequency Use ISO 8601 format: P1D, PT12H, P1W, P1M.

Related Skills

  • Use trade for a one-time swap instead of recurring.
  • Use batch to combine a DCA creation with other operations.
  • Use portfolio to check your overall positions and balances.

04 同仓库更多 Skills

jiayaoqijia
jiayaoqijia/cryptoskill

troves

Deposit and withdraw from Troves DeFi yield vault strategies on Starknet. View available strategies, check positions, and manage vault deposits. Use this skill when the user mentions Troves, vault, yield vault, DeFi vault, strategy, yield farming, vault deposit, vault withdraw, earning yield through vaults, passive yield strategies, or wants to deposit into or withdraw from a yield strategy — even if they don't say "Troves" explicitly.

★ 81
jiayaoqijia
jiayaoqijia/cryptoskill

trade

Swap tokens on Starknet via Fibrous DEX aggregator. Supports per-provider selection (avnu, ekubo, or auto to race all). Use this skill when the user wants to swap, exchange, trade, convert, buy, or sell one token for another on Starknet. Also use when the user asks about token prices, exchange rates, DEX routing, best swap route, or wants to check how much they would receive for a given amount — even if they don't explicitly say "swap".

★ 81
jiayaoqijia
jiayaoqijia/cryptoskill

staking

Stake, unstake, claim, and compound rewards for STRK, WBTC, tBTC, SolvBTC, and LBTC on Starknet. View validators, pools, and staking positions. Use this skill when the user mentions staking, delegating, validators, staking pools, rewards, compounding, unstaking, earning yield, passive income on crypto, or wants to earn on their STRK or BTC tokens — even if they don't say "stake" explicitly.

★ 81
jiayaoqijia
jiayaoqijia/cryptoskill

send

Send STRK, ETH, or any ERC-20 token to a Starknet address. Supports simulation (dry-run) before execution. Use this skill when the user wants to send, transfer, pay, tip, or move tokens to another wallet address on Starknet. Also trigger when the user mentions sending funds to someone, making a payment, transferring assets, or moving crypto to a specific address — even if they just say "pay 10 STRK to 0x...".

★ 81
jiayaoqijia
jiayaoqijia/cryptoskill

portfolio

View a comprehensive DeFi portfolio dashboard and optimize portfolio allocation via automated rebalancing. Use this skill when the user wants an overview, summary, dashboard, total value, net worth, portfolio rebalancing, target allocation, or wants to see all their DeFi positions across Starknet at once. Also trigger when the user asks "what do I have", "show me everything", "how much am I worth", "my positions", "my investments", "rebalance my portfolio", "I want 50% ETH", "optimize my holdings", or any request for a holistic view of their Starknet holdings — even if they don't explicitly say "portfolio".

★ 81
jiayaoqijia
jiayaoqijia/cryptoskill

multi-swap

Execute multiple token swaps in a single Starknet transaction via Fibrous (default). Supports per-provider selection (avnu, ekubo, or auto to race all). Supports 2-3 swap pairs bundled into one multicall. Use this skill when the user wants to swap multiple token pairs at once, do batch swaps, execute several trades simultaneously, perform parallel swaps, or do bulk trading in one transaction. Also trigger when the user mentions "two swaps", "three swaps", "swap X and Y at the same time", or wants to convert multiple tokens in a single call.

★ 81