skills/trade/SKILL.md
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".
npx skillsauth add ahmetenesdur/starkfi tradeInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Exchange one token for another on Starknet via Fibrous (default). Other providers (AVNU, Ekubo) can be selected with --provider, or use --provider auto to race all providers for the best price. All transactions are routed through the Paymaster by default (gas paid in STRK or configured token).
npx starkfi@latest status and npx starkfi@latest balance to verify connectivity and source token balance.--slippage <percent>.--simulate first for large trades so the user can review the estimated fee and expected output before committing.npx starkfi@latest tx-status <hash>.multi-swap skill instead.npx starkfi@latest trade <amount> <from> <to> [--provider <fibrous|avnu|ekubo|auto>] [--slippage <percent>] [--simulate] [--json]
| Parameter | Type | Description | Required |
| ------------ | ------ | ------------------------------------------------- | -------- |
| amount | number | Amount of source token to swap | Yes |
| from | string | Source token symbol (e.g. ETH, USDC) | Yes |
| to | string | Target token symbol (e.g. STRK, DAI) | Yes |
| --provider | string | Provider: fibrous (default), avnu, ekubo, auto (race all) | No |
| --slippage | number | Slippage tolerance in % (default: 1) | No |
| --simulate | flag | Estimate fees without broadcasting | No |
| --json | flag | Output as JSON | No |
User: "Swap 100 USDC for ETH"
npx starkfi@latest status
npx starkfi@latest balance --token USDC
npx starkfi@latest trade 100 USDC ETH
npx starkfi@latest tx-status <hash>
User: "How much ETH would I get for 500 USDC?"
npx starkfi@latest trade 500 USDC ETH --simulate
User: "Convert 0.5 ETH to STRK with 2% slippage"
npx starkfi@latest status
npx starkfi@latest balance --token ETH
npx starkfi@latest trade 0.5 ETH STRK --slippage 2
npx starkfi@latest tx-status <hash>
| Error | Action |
| ------------------------- | ------------------------------------------------------- |
| No route found | Liquidity may be too low or pair doesn't exist. |
| Insufficient balance | Check balance and suggest a smaller amount. |
| Provider unavailable | Specified provider is invalid. Valid: fibrous, avnu, ekubo. |
| All providers failed | All providers timed out or errored. Retry later. |
| Simulation failed | Route is invalid or would revert. Do not retry blindly. |
| Not authenticated | Run authenticate-wallet skill first. |
balance to check available tokens before trading.multi-swap for executing 2-3 swaps in a single transaction.batch for combining a swap with other operations (stake, supply, send, dca, troves).dca for recurring buy orders instead of a one-time swap.troves to deposit swap proceeds into yield vaults.lst for liquid staking after swapping to STRK.config to set a custom RPC if experiencing rate limits.testing
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.
testing
Liquid staking via Endur on Starknet — stake STRK to receive xSTRK, redeem xSTRK back to STRK, check positions, and view protocol stats. Yield is embedded in the xSTRK share price (no manual claim needed). Use this skill when the user mentions liquid staking, LST, xSTRK, Endur, liquid staking token, share price, instant staking, tradeable staking position, or wants a staking token they can trade or use in DeFi — even if they don't say "liquid staking" explicitly.
testing
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.
development
Manage confidential (private) transfers via Tongo Cash on Starknet — setup, fund, transfer, withdraw, ragequit, rollover using ZK proofs. Use this skill when the user wants to send tokens privately, hide transfer amounts, use zero-knowledge proofs, set up Tongo, fund or withdraw from a confidential account, perform an emergency exit (ragequit), or activate pending balance (rollover). Also trigger when the user says "send privately", "confidential transfer", "hide my transaction", "Tongo Cash", "ZK transfer", or any variation about privacy-preserving transfers — even if they don't use the word "confidential".