cmc-cli

name	cmc-cli
description	Use when working with the CoinMarketCap CLI, choosing shipped commands, or answering how to use cmc in scripts, TUI flows, or agent workflows.
version	0.1.0
metadata	{"requires":{"bins":["cmc"],"env":["CMC_API_KEY"]},"install":"go install github.com/openCMC/CoinMarketCap-CLI@latest\nmv \"$(go env GOPATH)/bin/coinmarketcap-cli\" \"$(go env GOPATH)/bin/cmc\"\n"}

CMC CLI

Overview

cmc is the CoinMarketCap-native CLI. Prefer commands that answer a user intent in one pass and keep stdout compact for scripts and agents.

Prerequisites

This skill requires:

• cmc CLI installed and available on PATH — see CoinMarketCap CLI for installation options
• CMC_API_KEY environment variable set with a valid CoinMarketCap API key
• Authentication completed via cmc auth

If either dependency is missing, the skill will not function.

Quick Reference

Need	Use	Notes
Exact asset lookup	resolve	Prefer --id, --slug, or --symbol for deterministic identity.
Quote + enrichments	price	Use --with-info and --with-chain-stats when you need more context.
Fuzzy discovery	search	Use for name/symbol lookup or DEX address discovery.
Market scan	markets, trending, top-gainers-losers	Use table output when a human is reading.
Time series	history	Use `--interval 5m
Global context	metrics, news, pairs	Good bundle commands; avoid splitting into smaller metrics unless necessary.
Live polling	monitor	Polling only, not websocket streaming.
Interactive views	tui	Human inspection only; not for scripting.

Output Rules

• Default output is compact JSON.
• Use -o table for readable terminal output.
• Use --dry-run to inspect request shape without calling the API.
• Keep identity flags explicit when determinism matters.

Slash Command Note

This skill is guidance for using the cmc runtime. It does not create a built-in /cmc slash command by itself.

• Hosts may surface it as a skill, reusable workflow, or contextual suggestion.
• A /cmc command only exists if the host explicitly adds a slash-command wrapper or alias for this skill.
• For hosts such as Claude Code or OpenClaw, do not assume skill registration alone will produce /cmc.

Workflow

1. Use resolve when the user already knows the asset.
2. Use search when the user knows a name, symbol, or contract but not the exact identity.
3. Use price for quotes, then add --with-info or --with-chain-stats only when the bundle is needed.
4. Use markets, trending, top-gainers-losers, metrics, news, or pairs for broader market context.
5. Use tui only when a human wants an interactive terminal view.

Common Mistakes

• Do not use search as an exact-lookup replacement when resolve is available.
• Do not send scripting workloads to tui.
• Do not split a bundle into smaller commands unless the user asked for the narrow view.
• Do not assume every numeric or token-like string should map to a symbol; prefer the shipped command heuristics.