Skill

coingecko

Agent-native CLI for the CoinGecko public crypto API. Wraps price lookups, market data, search, trending, and global market endpoints behind --compact output and typed exit codes (0 / 7 rate-limited). No API key required for basic endpoints; offline-friendly via a local SQLite mirror. Read-only by design.

Verified: 2026-05-13 (printing-press-ingest-2026-05-13+enrich-capability-skill)

When to use coingecko

Choose if

You need read-only crypto price / market data inside an agent loop and want a free, no-API-key CLI with typed exit codes and a local SQLite cache. Prefer this over hand-rolling fetches against api.coingecko.com when the workflow benefits from --compact output and rate-limit-aware retries.

Avoid if

You need write operations (trading, order placement, wallet ops) — CoinGecko is data-only and this CLI is strictly read-only. Also avoid for sub-second realtime tick data: free-tier rate limits and cached SQLite responses make this unsuitable for HFT-style use cases.

Risk Flags

  • MEDIUM rate_limit Upstream CoinGecko free-tier API enforces undisclosed rate limits; CLI surfaces these as exit code 7 (rate-limited) but does not lift the upstream cap. Agents on heavy workloads should cache via the local SQLite mirror.
  • LOW scope Read-only by design — no create / update / delete / publish / send / mutate. Agents needing exchange trading or order placement must use a different tool (CoinGecko exposes data only, not trading).
  • LOW data_quality "Offline-friendly" implies cached results may be stale. Agents that need realtime tick prices must bypass cache via a fresh query and accept the rate-limit cost.

Cost

Type: Free · Free tier: "Free tier, no API key required for basic endpoints" per upstream README. The CLI binary is MIT-licensed and free to install. Higher tiers (Pro / Enterprise) require a CoinGecko paid plan; the README does not document Pro-key flag handling explicitly.

Install

Default

npx -y @mvanhorn/printing-press install coingecko

Setup docs →

Estimated time to first success: ~5 min

Dependencies

Minimum runtime: Node.js (for npx install) or Go 1.26.3+ (source install)

Distribution

Repository
https://github.com/mvanhorn/printing-press-library
License
MIT