themystic07/covalentagentskill
Overview
This skill integrates Covalent GoldRush Foundational and Streaming APIs with TypeScript and Python SDKs to deliver unified historical and real-time blockchain data across 100+ chains. It provides ready-made service clients for balances, transactions, NFTs, pricing, security checks, and WebSocket streaming for live market and wallet events. The package focuses on practical examples, authentication patterns, and error handling to get production integrations started quickly.
How this skill works
The integration initializes a GoldRush client with your API key and exposes modular services (Balance, Transaction, NFT, Base, Security, Pricing) for REST queries. For live data, the Streaming service opens GraphQL-over-WebSocket subscriptions to receive OHLCV, new DEX pairs, liquidity updates, and wallet activity. Responses follow a common structure with an error flag and paginated data, and SDKs include helpers for pagination and connection lifecycle events.
When to use it
- Fetch aggregated token balances and USD quotes for user wallets
- Retrieve transaction history, decoded logs, and wallet summaries
- Stream real-time price candles, new DEX pairs, or wallet activity for trading and monitoring
- Audit token approvals and calculate value-at-risk for security reviews
- Query historical token pricing for analytics and portfolio valuation
Best practices
- Store API keys in environment variables; never hardcode them
- Always check response.error before accessing response.data to avoid crashes
- Implement pagination using next()/prev() for large result sets
- Use exponential backoff and retry logic for rate limit or transient errors
- Filter spam tokens with no_spam=true and resolve names via ENS/Lens when available
Example use cases
- Build a wallet dashboard showing balances, NFT holdings, and historical P&L
- Power trading bots or analytics dashboards with OHLCV token and pair streams
- Create automated security scans to list token approvals and value-at-risk per wallet
- Monitor cross-chain activity for an address to trigger alerts when it appears on new networks
- Index historical transactions and logs for forensic analysis or tax reporting
FAQ
TypeScript/JavaScript and Python SDKs are provided with examples for both languages.
How do I authenticate requests?
Initialize the client with your GoldRush API key or pass it as a Bearer token in requests; use environment variables to store keys.
Can I stream real-time events?
Yes. The Streaming API uses GraphQL over WebSocket and supports OHLCV, new DEX pairs, liquidity and wallet activity streams.
How do I handle rate limits?
Implement exponential backoff and retries, respect pagination limits, and cache frequent lookups to reduce request volume.
