CoinStats CLI

Command-line interface for the CoinStats Public API, designed for AI agents and terminal-first workflows.

Install

Install the CLI:

npm install -g coinstats-cli

Install all CoinStats skills without the interactive picker:

npx skills add CoinStatsHQ/coinstats-cli --all

Install a specific skill only:

npx skills add CoinStatsHQ/coinstats-cli --skill coinstats-wallet-data

Install all CoinStats skills for one agent without prompts:

npx skills add CoinStatsHQ/coinstats-cli --skill '*' --agent codex -y

Local Checkout

npm install
npm run build
npm link
coinstats --help

If you do not want to link the binary globally, run commands from the repo with:

npm exec --package . coinstats -- --help

Auth

1. Sign up at openapi.coinstats.app.
2. Create a CoinStats API key in the dashboard.
3. Configure the CLI with that key:

export COINSTATS_API_KEY=<your-api-key>
coinstats whoami
# optional: save the current key to ~/.coinstats/config.json
coinstats login

Environment variables take priority over the saved config in ~/.coinstats/config.json.

You can verify what the CLI will use with:

coinstats whoami

Command Groups

coinstats coins <command>
coinstats tickers <command>
coinstats wallet <command>
coinstats exchange <command>
coinstats fiats <command>
coinstats nft <command>
coinstats news <command>
coinstats markets <command>
coinstats portfolio <command>
coinstats currencies <command>
coinstats insights <command>
coinstats usage <command>
coinstats schema --pretty

The CLI currently maps all 52 public operations in the published CoinStats OpenAPI snapshot.

Output

Default output is machine-friendly JSON:

{"success":true,"data":{}}
{"success":false,"error":"message","code":"ERROR_CODE","status":400}

Supported output controls:

• --pretty
• --table
• --format json|csv
• --fields id,name,price

Mutating commands require --yes.

Examples

coinstats coins list --limit 5 --pretty
coinstats insights fear-and-greed --pretty
coinstats wallet sync-transactions --blockchain ethereum --body-file ./wallet-sync.json --yes
coinstats portfolio connect-wallet --body-file ./wallet.json --yes
coinstats exchange sync --portfolio-id <id> --yes
coinstats schema --pretty

Skills

This repo ships section-based skills under skills/:

• coinstats-coins
• coinstats-tickers
• coinstats-wallet-data
• coinstats-exchange
• coinstats-fiats
• coinstats-nft
• coinstats-news
• coinstats-markets
• coinstats-portfolio
• coinstats-currencies
• coinstats-insights
• coinstats-usage

Development

npm install
npm run generate:client
npm run build
npm link
npm test
npm run lint
npm run check:coverage

Generated SDK source lives in src/generated/. The OpenAPI snapshot lives in openapi/coinstats-public-api.json.