Trade / Swap Tokens

Hard Rules (CRITICAL)

1. Pre-Flight Check: Before ANY trade, you MUST run:

   • npx fibx status

   • npx fibx balance

     (ensure you have the source token)
2. Chain Specification:
   • If the user mentions a specific chain (e.g., "on Monad", "for my Citrea wallet"), you MUST include the

     --chain <name>

     parameter.
   • If the user DOES NOT mention a chain, you MUST either:
     • Explicitly state the default: "I will perform this trade on Base. Is that correct?"
     • OR ask for clarification: "Which chain would you like to trade on? Base, Citrea, HyperEVM, or Monad?"
3. Slippage Safety: The default slippage is 0.5%. If you need to change this (e.g., for volatile tokens), you MUST ask the user for confirmation first.
4. Approval Limits: The CLI defaults to "Exact Approval" (approves only the amount to be swapped).
   • Do NOT use

     --approve-max

     unless the user explicitly requests "infinite approval" or "max approval".
5. Simulation & Verification: The CLI performs a route check before swapping. If this fails, do not proceed. After swapping, verify the transaction with the

   tx-status

   skill.

Usage

npx fibx trade <amount> <from_token> <to_token> [options]

Arguments

amount

1.5

100

from_token

ETH

USDC

to_token

WETH

DAI

Options

--chain <network>

base

citrea

hyperevm

monad

base

--slippage <n>

1.0

0.5

--approve-max

--json

Examples

Standard Swap (Base)

1. npx fibx status

2. npx fibx balance

3. npx fibx trade 0.1 ETH USDC

4. npx fibx tx-status <hash>

Swap with Custom Slippage

1. Checks info.
2. Agent: "Confirming: You want to swap 1000 DEGEN to ETH with 2% slippage. Is this correct?"
3. User confirms.

4. npx fibx trade 1000 DEGEN ETH --slippage 2

Swap on Monad

1. npx fibx status --chain monad

2. npx fibx trade 1 MON USDC --chain monad

Error Handling

• "No route found": The trade path might not exist or liquidity is too low.
• "Insufficient balance": Check

  balance

  again.
• "Slippage exceeded": The price moved unfavorably; suggest retrying with higher slippage (after user confirmation).