crypto-tracker

What This Skill Does

The crypto-tracker skill is a robust tool designed for OpenClaw agents to interface with the CoinGecko API. It provides real-time market data, price lookups, and sophisticated alert management for over 15,000 cryptocurrencies. Whether you need to check the current market cap of a specific asset, search for coin IDs, or set persistent price and percentage-change thresholds, this skill simplifies the process through intuitive command-line integration. It includes built-in support for common coin aliases like 'btc', 'eth', and 'sol', ensuring users don't need to know the specific CoinGecko API IDs for popular assets.

Installation

To add this capability to your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/dbhurley/crypto-tracker

Ensure that your environment is configured for 'uv' usage as specified in the script paths. The skill automatically manages its own storage in the base directory under 'data/alerts.json', ensuring your preferences and thresholds persist across agent restarts.

Use Cases

• Real-time Portfolio Monitoring: Use the skill to pull current pricing for a basket of coins to keep track of your holdings.
• Automated Trading Alerts: Set 'above' or 'below' price thresholds to get notified when a coin hits your target entry or exit point.
• Market Volatility Tracking: Utilize the 'change', 'drop', or 'rise' alerts to receive notifications during high-volatility events, such as a 10% sudden drop.
• Automated Cron Jobs: Integrate the 'check-alerts' command into your server's cron jobs to ensure your agent proactively checks prices every 15 minutes, even when not actively prompted.

Example Prompts

1. "Check the current prices for bitcoin and ethereum with full market details."
2. "Set an alert for me; let me know if solana drops by more than 10% in the next 24 hours."
3. "Search for the coin ID for Chainlink so I can set a custom price threshold for it."

Tips & Limitations

• Rate Limiting: The skill utilizes the CoinGecko free tier, which supports 10-30 requests per minute. Avoid aggressive polling frequencies shorter than 15 minutes to prevent being blocked.
• JSON Output: For advanced users building custom dashboards or integrations, append the --json-output flag to any command to receive data in a machine-readable format.
• Alert Cooldown: The system includes a default 1-hour cooldown for repeated notifications, which helps prevent notification fatigue during volatile market conditions.