skills/trade/SKILL.md
Swap tokens using Fibrous aggregation on Base, Citrea, HyperEVM, or Monad. Finds optimal route, simulates before execution. Supports --simulate for gas-only estimation without sending.
npx skillsauth add ahmetenesdur/fibx-agentic-wallet-skills 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 via Fibrous aggregation. The CLI finds the best route, handles token approvals, simulates the swap, and executes.
Note: Automatically detects and executes Wrap (Native -> Wrapped) and Unwrap (Wrapped -> Native) operations directly via contract calls, bypassing aggregation to save gas.
npx fibx@latest status and npx fibx@latest balance to verify connectivity and source token balance.--chain <name>. If not specified, default to base and state it.--slippage.--approve-max unless the user explicitly requests it.tx-status with the same --chain flag.| Chain | Flag | Native Token |
| -------- | ------------------ | ------------ |
| Base | --chain base | ETH |
| Citrea | --chain citrea | cBTC |
| HyperEVM | --chain hyperevm | HYPE |
| Monad | --chain monad | MON |
npx fibx@latest trade <amount> <from_token> <to_token> [--chain <chain>] [--slippage <n>] [--approve-max] [--simulate] [--json]
| Parameter | Type | Description | Required |
| ------------- | ------ | ---------------------------------------- | -------- |
| amount | number | Amount of source token to swap | Yes |
| from_token | string | Source token symbol (e.g. ETH, USDC) | Yes |
| to_token | string | Target token symbol (e.g. USDC, DAI) | Yes |
| chain | string | base, citrea, hyperevm, or monad | No |
| slippage | number | Slippage tolerance in % (e.g. 1.0) | No |
| approve-max | flag | Use infinite approval instead of exact | No |
| simulate | flag | Estimate gas without executing | No |
| json | flag | Output as JSON | No |
Default chain: base. Default slippage: 0.5.
User: "Swap 0.1 ETH for USDC"
npx fibx@latest status
npx fibx@latest balance
npx fibx@latest trade 0.1 ETH USDC
npx fibx@latest tx-status <hash>
User: "Buy USDC with 1 MON on Monad"
npx fibx@latest status
npx fibx@latest balance --chain monad
npx fibx@latest trade 1 MON USDC --chain monad
npx fibx@latest tx-status <hash> --chain monad
User: "Wrap 1 ETH to WETH on Base"
npx fibx@latest status
npx fibx@latest balance
npx fibx@latest trade 1 ETH WETH --chain base
npx fibx@latest tx-status <hash>
User: "Unwrap 0.5 WMON on Monad"
npx fibx@latest status
npx fibx@latest balance --chain monad
npx fibx@latest trade 0.5 WMON MON --chain monad
npx fibx@latest tx-status <hash> --chain monad
| Error | Action |
| ---------------------- | ------------------------------------------------------------- |
| No route found | Liquidity may be too low or pair doesn't exist on the chain. |
| Insufficient balance | Check balance and suggest a smaller amount. |
| Slippage exceeded | Price moved unfavorably — suggest retrying with --slippage. |
| Simulation failed | Route is invalid or would revert. Do not retry blindly. |
| Not authenticated | Run authenticate-wallet skill first. |
| Rate limit / 429 | Use config skill to set a custom RPC. |
quote BEFORE trading to check the expected price and exchange rate.balance BEFORE trading to verify sufficient source token balance.portfolio to see all holdings with USD values before deciding what to trade.tx-status AFTER trading to confirm the swap succeeded.config to set a custom RPC if you encounter rate limit errors.aave to supply swapped tokens into Aave V3 for yield.testing
Get a swap price quote without authentication. Check exchange rates, output amounts, and route info for any token pair on Base, Citrea, HyperEVM, or Monad. No wallet or session required.
testing
Check the on-chain status of a transaction and get the block explorer link. Supports Base, Citrea, HyperEVM, and Monad.
testing
Send native tokens (ETH, cBTC, HYPE, MON) or ERC-20 tokens to an address on Base, Citrea, HyperEVM, or Monad. Simulates before sending. Supports --simulate for gas-only estimation.
data-ai
Show a consolidated cross-chain portfolio overview with USD valuations for all token holdings and DeFi positions. Use when the user asks about their portfolio, net worth, total value, or asset breakdown across chains.