freaky.fi

Command Line Interface

Get swap quotes and trade directly from your terminal. Same 10 aggregators, same best rate.

The same quote comparison that powers freaky.fi, available in your terminal. Query 10 aggregators, see the results ranked, and open the swap page in your browser to execute.

Install

npm install -g @freaky.fi/cli

Or run without installing:

npx @freaky.fi/cli swap 1000 usdc for eth on base

After installing globally, you can call swap directly:

swap 1000 usdc for eth on base
swap 0.5 eth for usdc on arbitrum
swap 10 dai for weth

The chain defaults to Ethereum if you leave it out. Tokens match by symbol or contract address, case-insensitive.

After selecting a quote, the CLI opens the swap execution page in your browser. Connect your wallet there and confirm.

Configuration

Set defaults so you don't have to repeat yourself.

freaky config                    # interactive setup
freaky config set chain base     # default chain
freaky config set slippage 0.5   # default slippage
freaky config get chain          # read a value

Prompt Format

[amount] [token] for [token] on [chain]
  • amount - how much to sell (1000, 0.5)
  • token - symbol (ETH, USDC) or contract address
  • chain - name or ID (base, optimism, 8453, 10)

On this page