Crypto CLI — 18 commands for market, futures, funding & narratives from your terminal.

Run pip install sharpe-mcp to install the package. This installs both the CLI (accessed via the sharpe command) and the MCP server (accessed via the sharpe-mcp command) in a single package. After installation, run sharpe market to verify the installation works. The CLI requires Python 3.8+ and works on macOS, Linux, and Windows. No additional configuration or API key is needed to start using it immediately.

No. The CLI works out of the box with free public endpoints and no authentication required. All 18 commands, watch mode, and output formatting are available without an API key. For higher rate limits and access to authenticated endpoints with more detailed data, you can optionally set a SHARPE_API_KEY environment variable. Free rate limits are sufficient for interactive terminal use and light scripting.

The 18 commands are: market (overview), funding (funding rates), futures (futures analytics), options (options data), arb (arbitrage opportunities), narratives (narrative performance), ecosystems (ecosystem data), memecoins (memecoin narratives), news (latest news), search (token search by market cap), gems (gem finder), predict (price predictions), briefing (daily market briefing), watch (live refresh mode), heatmap (market heatmap), correlation (correlation matrix), compare (coin comparison), and web-traffic (web traffic data).

Yes. All commands support --json for structured JSON output and --csv for CSV output. When piped to another command, colored formatting is automatically disabled for clean machine parsing. Example workflows include piping funding rates to jq for filtering, saving arbitrage opportunities to CSV for spreadsheet analysis, and integrating market briefings into Slack or Telegram bots via webhook scripts. The CLI is designed as a composable Unix tool.

Watch mode auto-refreshes any command's output every 30 seconds. Run sharpe watch followed by any command name — for example, sharpe watch market or sharpe watch funding. The terminal clears and redraws with fresh data on each cycle. Watch mode is particularly useful for monitoring funding rates approaching settlement, tracking arbitrage spreads in real-time, or maintaining a live market dashboard in a terminal window during trading sessions.

The sharpe briefing command generates a comprehensive market summary including: current BTC and ETH prices with 24h changes, total crypto market cap, BTC dominance, top 5 performing narratives, the 5 highest and lowest funding rates across exchanges, the best current spot-perp and cross-exchange arbitrage opportunities, and notable market events. The briefing synthesizes data from multiple Sharpe products into a single terminal output.

The CLI fetches live data from Sharpe's API on each command invocation. Data freshness depends on the underlying product: funding rates update every 1-8 hours per exchange, futures and options snapshots every 5-10 minutes, narratives and ecosystems every 30 minutes, and news from the latest indexed source rows. In watch mode, the selected command re-fetches data every 30 seconds, always showing the most recent available data.

Yes. The CLI is free to install and use with all 18 commands, watch mode, daily briefing, and all output formats (colored tables, JSON, CSV) available without an API key. Rate limits on free endpoints are sufficient for interactive terminal use and light scripting. For automated pipelines making frequent requests, add a SHARPE_API_KEY for higher rate limits.

On macOS and Linux, add export SHARPE_API_KEY=your_key to ~/.zshrc or ~/.bashrc and restart your shell. On Windows, use setx SHARPE_API_KEY your_key in PowerShell or the system environment variables UI. For one-off use, prefix the command: SHARPE_API_KEY=your_key sharpe market. The CLI reads the variable on each invocation, so no restart of the CLI is needed. Your key is never logged or transmitted to third parties — it's only sent as a bearer token to Sharpe's API endpoints.

Yes. All commands support --json and --csv output modes that are machine-parseable. Common pipelines include sharpe funding --json | jq '.[] | select(.apr > 50)' to filter high-APR opportunities, sharpe arb --csv > arb-opportunities.csv for spreadsheet analysis, and sharpe news --json | jq '.[0:5]' to get the top 5 stories. When output is detected as piped (non-TTY), the CLI automatically disables ANSI color codes so downstream tools receive clean text. This makes the CLI a first-class Unix citizen for building custom monitoring, alerting, and trading workflows.