Home /docs

fere cli

Trade crypto, chat with AI, manage portfolios — from your terminal. Built for developers and AI agents.

curl -fsSL https://api.fereai.xyz/install.sh | sh

or: pip install fere-cli · v0.2.3

Get Started

$ fere auth
Agent 'my-bot' authenticated. Keys saved to ~/.fere/keys.json

$ fere chat "what's the price of ETH?"
ETH is trading at $3,245.12 on Base (chain 8453)...

$ fere swap --chain-in 8453 --chain-out 8453 \
--token-in 0xEeee...EEeE --token-out 0x8335...2913 \
--amount 1000000000000000000
Swap complete. Tx: 0xabc...def

$ fere --json holdings | jq '.data'
{"holdings": [{"symbol": "ETH", "balance": "0.95"}]}

Why CLI?

For Developers

Script swaps, automate research, pipe JSON into your tools. Integrates with any shell workflow or CI/CD pipeline.

For AI Agents

Machine-readable --json output, non-interactive mode, clean exit codes. Built for agentic tool-use.

Full Trading Suite

Swap, limit orders, stop-loss hooks, yield earning — everything the SDK offers, from your terminal.

Commands

Command	Description
`fere auth`	Authenticate and register a new agent
`fere whoami`	Show agent identity and wallets
`fere credits`	Check credit balance
`fere claim-daily`	Claim daily credits bonus
`fere chat "query"`	One-shot chat with AI agent
`fere chat`	Interactive chat REPL
`fere chat --stream`	Stream response events live
`fere threads`	List recent chat threads
`fere swap`	Execute a token swap
`fere limit-order create`	Create a limit order
`fere limit-order list`	List limit orders
`fere limit-order cancel ID`	Cancel a limit order
`fere hooks set`	Set stop-loss / take-profit
`fere wallets`	Show wallet addresses
`fere holdings`	Show token holdings
`fere notifications`	Show notifications
`fere earn info`	Show APY and vault details
`fere earn deposit`	Deposit USDC
`fere earn withdraw`	Withdraw USDC
`fere earn positions`	Show yield positions
`fere chains`	List supported blockchains
`fere status`	Check API connectivity
`fere config`	Show / edit CLI config

Global Flags

Flag	Env Var	Description
`--json`	—	Machine-readable JSON output
`--quiet`	—	Minimal output (key value only)
`--agent NAME`	`FERE_AGENT_NAME`	Agent name override
`--base-url URL`	`FERE_BASE_URL`	API base URL override

JSON Output

$ fere --json credits
{"ok": true, "data": {"credits_available": 150.0}}

$ fere --json chat --stream "price of SOL"
{"event": "meta", "data": {"chat_id": "abc123"}}
{"event": "chunk", "data": {"text": "SOL is"}}
{"event": "answer", "data": {"text": "SOL is trading at..."}}