A secure, read-only crypto market data skill that fetches live prices from CoinGecko with automatic Kraken fallback.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install coingecko-2
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install coingecko-2 using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is CoinGecko Crypto Price Skill?
The CoinGecko Crypto Price Skill gives Hermes agents live Bitcoin, Ethereum, and multi-asset cryptocurrency market data through a simple, standalone integration. It supports CoinGecko Demo and Pro API keys, 24-hour price changes, formatted quotes, and market data for thousands of assets.
Designed for Openclaw Skills workflows, the skill isolates credentials in environment variables and never exposes API keys in prompts, agent memory, or logs. When CoinGecko is unavailable, rate-limited, or unconfigured, it can automatically use the public Kraken API for supported major trading pairs.
CoinGecko Crypto Price Skill Use Cases
- Monitor live BTC/USD and ETH/USD prices in agent conversations or dashboards
- Supply current crypto quotes to daily intelligence briefs, newsletters, and content generators
- Fetch prices for multiple assets in a single command
- Track 24-hour price movement, market capitalization, and trading volume where supported
- Build read-only market monitoring, alerting, research, and reporting workflows
- Maintain price availability through automatic CoinGecko-to-Kraken fallback
- Validate API connectivity, credentials, and rate-limit status before production use
- Provide dependable crypto data to downstream Openclaw Skills without coupling them to CoinGecko implementation details
How CoinGecko Crypto Price Skill Works
- The skill reads the optional CoinGecko credential from the isolated
CG_API_KEYenvironment variable. fetch_price.pyorfetch_multi_asset.pysends a read-only request to CoinGecko for current asset data.- The integration automatically supports both Demo and Pro CoinGecko keys without code changes.
- If the key is unavailable, CoinGecko is rate-limited, or a request fails, the client retries with backoff and can switch to the public Kraken API when
CG_FALLBACK_KRAKEN=true. - Kraken supplies supported major-pair data, while CoinGecko remains the preferred source for broader asset coverage and richer market fields.
- The scripts normalize the response into structured JSON containing prices, formatted values, change data, source, and status information.
health_check.pyverifies connectivity, key validity, API type, and available rate-limit information.- Calling agents consume the public market data while the API credential remains outside prompts, memory, and returned payloads.
CoinGecko Crypto Price Skill Setup
- Create the Hermes skill environment and install the required Python dependencies.
python3 -m venv [config]/.hermes/coingecko-env
[config]/.hermes/coingecko-env/bin/pip install requests urllib3 python-dotenv
Obtain a free CoinGecko Demo key from the CoinGecko API documentation, or configure a Pro key for higher-volume workloads.
Store the credential in the skill's protected
.envfile. Do not paste the key into prompts or commit the file to source control.
cd [config]/.hermes/skills/coingecko
printf 'CG_API_KEY=your_coingecko_key\nCG_FALLBACK_KRAKEN=true\n' > .env
chmod 600 .env
- Add
.envto.gitignoreand ensure the runtime can read the isolated environment variables.
echo '.env' >> .gitignore
- Verify connectivity and key configuration.
python3 [config]/.hermes/skills/coingecko/scripts/health_check.py
- Fetch a Bitcoin quote and test multi-asset support.
python3 [config]/.hermes/skills/coingecko/scripts/fetch_price.py
python3 [config]/.hermes/skills/coingecko/scripts/fetch_multi_asset.py bitcoin ethereum
- If no CoinGecko key is configured, leave
CG_FALLBACK_KRAKEN=trueenabled for supported Kraken pairs such as BTC/USD and ETH/USD. Usecurl -s https://api.coingecko.com/api/v3/pingto diagnose network or DNS problems.
CoinGecko Crypto Price Skill Data Schema & Taxonomy
Skill files
| Path or file | Purpose |
|---|---|
[config]/.hermes/skills/coingecko/ |
Skill installation directory |
scripts/fetch_price.py |
Retrieves a live single-asset quote, primarily BTC/USD |
scripts/fetch_multi_asset.py |
Retrieves quotes for multiple asset IDs |
scripts/health_check.py |
Tests API access, credentials, and rate-limit state |
.env |
Private runtime configuration containing CG_API_KEY and fallback settings |
[config]/.hermes/coingecko-env |
Python virtual environment |
Configuration taxonomy
CG_API_KEY: Optional CoinGecko Demo or Pro credential; required for full CoinGecko access and broad altcoin coverage.CG_FALLBACK_KRAKEN: Optional boolean switch controlling unauthenticated Kraken fallback; defaults totrue.- CoinGecko Demo: Free, rate-limited access generally supporting approximately 10–50 calls per minute.
- CoinGecko Pro: Paid, higher-volume access with expanded limits.
- Kraken fallback: Public, authentication-free source with more limited major-pair coverage.
Response fields
Typical structured responses include:
price: Numeric current price.price_str: Human-readable formatted price such as$81,291.00.change_24h: Percentage movement over 24 hours when available.market_capandvolume: Additional CoinGecko market fields where supported.source: The provider used, such as CoinGecko or Kraken.api_status,key_type, andrate_limit_remaining: Health-check metadata.
All returned data is public, read-only market information. Credentials are not included in response objects, logs, prompts, or agent memory.
CoinGecko Crypto Price Skill Advanced Features
- Dual-source redundancy with automatic CoinGecko and Kraken provider failover
- Support for both free Demo and paid Pro CoinGecko credentials with automatic key-type handling
- Exponential backoff and retry behavior for transient failures and rate limits
- Multi-asset querying for Bitcoin, Ethereum, and thousands of other CoinGecko asset IDs
- Optional market capitalization, trading volume, and 24-hour movement fields
- Credential isolation through
.envand environment-variable-only access - Read-only architecture with no trading, account access, signing, or write permissions
- Health checks that expose API status, key type, and remaining rate-limit information without revealing secrets
- Deterministic fallback configuration through
CG_FALLBACK_KRAKEN - Timestamped, auditable API activity and source reporting for downstream Openclaw Skills
- Standalone design that can provide data to monitoring, research, alerting, and content workflows without dependencies on calling systems
- MIT-licensed implementation suitable for extension and integration into custom Hermes agent automations
SKILL.md
Loading
Related Openclaw Skills
Douyin Comment-to-Demo Clips
Convert seller-approved Douyin comment objections and still images into separate, reviewable 2–15 second talking demo clips.
Fund Quarterly Report Talking Clips
Turn an approved fund quarterly report highlight sheet and authorized stills into 2 to 8 separate, fact-bound talking clips.
Game UI Voice Pack
Game UI Voice Pack converts approved game interface copy into 8 to 20 individually labeled, reviewable voiceover clips.
Insurance Renewal Reminder Talking Clips
Generate one short, schedule-accurate insurance renewal reminder talking clip per authorized still without stitching or inventing policy facts.
Enterprise GEO Optimization
An end-to-end enterprise GEO operating system for diagnosing, improving, distributing, measuring, and iterating brand visibility in generative search.
Auto Google Review Reply Merchant Onboarding
An end-to-end merchant onboarding skill that connects Google Business Profiles and configures AI-powered Google review auto-replies.
Featured*
