# Crypto Market CLI

> Track crypto prices, portfolios, and market data via CoinGecko. Use when checking coin prices, managing a portfolio, setting alerts, or comparing cryptocurrencies.

- Skill: `bytesagain/crypto-market-cli` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add bytesagain/crypto-market-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bytesagain/crypto-market-cli/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: bytesagain (https://skillmd.com/u/bytesagain)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/bytesagain/crypto-market-cli

---


# crypto-market-cli

Cryptocurrency market toolkit — get live prices from CoinGecko API, manage watchlists and portfolios, view price history with sparkline charts, set price alerts, and compare coins.

## Commands

### `price`

Get live price, 24h change, and market cap for a coin from CoinGecko.

```bash
scripts/script.sh price bitcoin
scripts/script.sh price ethereum eur
```

### `search`

Search for coins by name or symbol. Returns top 10 results with rank.

```bash
scripts/script.sh search "solana"
```

### `track`

Add a coin to your local watchlist.

```bash
scripts/script.sh track bitcoin
scripts/script.sh track ethereum
```

### `watchlist`

Display all watchlist coins with current prices and 24h changes (fetched live).

```bash
scripts/script.sh watchlist
```

### `portfolio`

Manage your portfolio — record buys and view current holdings with live P/L.

```bash
scripts/script.sh portfolio add bitcoin 0.5 42000
scripts/script.sh portfolio add ethereum 2.0 3200
scripts/script.sh portfolio show
```

### `history`

View price history for a coin over N days, with sparkline visualization.

```bash
scripts/script.sh history bitcoin 7
scripts/script.sh history ethereum 30
```

### `compare`

Side-by-side price comparison of two coins.

```bash
scripts/script.sh compare bitcoin ethereum
```

### `gas`

Ethereum gas price information and links.

```bash
scripts/script.sh gas
```

### `alert`

Set and view price alerts (stored locally).

```bash
scripts/script.sh alert add bitcoin 50000 above
scripts/script.sh alert add ethereum 2000 below
scripts/script.sh alert list
```

### `stats`

Show usage statistics — watchlist size, portfolio entries, alerts count.

```bash
scripts/script.sh stats
```

### `export`

Export portfolio data as JSON or CSV.

```bash
scripts/script.sh export json
scripts/script.sh export csv
```

### `help`

```bash
scripts/script.sh help
```

### `version`

```bash
scripts/script.sh version
```

## Examples

```bash
# Quick price check
scripts/script.sh price bitcoin
scripts/script.sh price solana

# Build a watchlist
scripts/script.sh track bitcoin
scripts/script.sh track ethereum
scripts/script.sh track solana
scripts/script.sh watchlist

# Track portfolio P/L
scripts/script.sh portfolio add bitcoin 0.1 45000
scripts/script.sh portfolio show

# Research
scripts/script.sh history bitcoin 30
scripts/script.sh compare bitcoin ethereum
```

## Configuration

| Variable | Required | Description |
|----------|----------|-------------|
| `CRYPTO_CLI_DIR` | No | Data directory (default: `~/.crypto-market-cli/`) |

## Data Storage

All data saved in `~/.crypto-market-cli/`:
- `watchlist.txt` — Tracked coins
- `portfolio.jsonl` — Buy records
- `alerts.jsonl` — Price alerts
- `history.log` — Query history

## Requirements

- bash 4.0+
- curl (for CoinGecko API calls)
- python3 (for JSON parsing)

CoinGecko free API — no key required, rate-limited to ~10 requests/minute.

---

*Powered by BytesAgain | bytesagain.com | hello@bytesagain.com*