ahmetenesdurahmetenesdur/starkfi/skills/dca/SKILL.md

dca

Skill2 starsChanged 8 months agoMITView on GitHub

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.

1 other project uses a version of this.

Adopted by

Most recently taken up by

aibtcdev/skillstheir own version, first seen Oct 26, 2026

Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
aibtcdev/skills★ 11same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository13 other files it gives its agents.
- authenticate-walletSkill
- balanceSkill
- batchSkill
- confidentialSkill
- configSkill
- lendingSkill
- lstSkill
- multi-swapSkill
- portfolioSkill
- sendSkill
- stakingSkill
- tradeSkill
- trovesSkill

The file

We split this skill into the rules it gives an agent

7 rules. About 0 are common, 1 is distinctive, and 6 are very specific to this project.

≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
6
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Distinctive:
Create recurring buy orders that automatically swap a fixed amount of one token into another at regular intervals.
line 24
Very specific:
BEFORE any DCA operation, you MUST run npx starkfi@latest status and npx starkfi@latest balance to verify connectivity and funds.
line 34
Very specific:
ALWAYS run dca-preview before dca-create to verify the expected output per cycle.
line 35
Very specific:
AFTER a successful creation, verify with npx starkfi@latest tx-status <hash>.
line 39
Very specific:
Use trade for a one-time swap instead of recurring.
line 133
Very specific:
Use batch to combine a DCA creation with other operations.
line 134
Very specific:
Use portfolio to check your overall positions and balances.
line 135

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

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

BEFORE any DCA operation, you MUST run npx starkfi@latest status and npx starkfi@latest balance to verify connectivity and funds.
ALWAYS run dca-preview before dca-create to verify the expected output per cycle.
The --per-cycle flag is required for dca-create. It sets the amount sold each execution cycle.
Frequency uses ISO 8601 duration format: P1D (daily), PT12H (12 hours), P1W (weekly).
Suggest using --simulate first to verify the DCA order would succeed.
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.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free