Skip to content

TheMystic07/CovalentAgentSkill

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

Covalent GoldRush API Skill

A comprehensive Claude Code skill for integrating with Covalent GoldRush - the most comprehensive blockchain data API suite.

Features

  • Foundational API - Access structured historical blockchain data across 100+ chains
  • Streaming API - Real-time WebSocket subscriptions for live blockchain events
  • TypeScript & Python - Complete examples for both SDKs
  • Cross-Chain - Multi-chain balance queries and activity detection

Installation

Using npx skills (Recommended)

npx skills add TheMystic07/CovalentAgentSkill

Manual Installation

  1. Clone or download this skill
  2. Copy to your project's .agent/skills/ directory
  3. Reference from your SKILL.md or agent configuration
# Clone the repository
git clone https://github.com/TheMystic07/CovalentAgentSkill.git

# Copy to your project
cp -r CovalentAgentSkill/.agent/skills/goldrush your-project/.agent/skills/

For Claude Code

Add to your Claude Code project by placing the skill in .agent/skills/goldrush/ or use the skills CLI.

Prerequisites

  1. Get a GoldRush API Key: Sign up at GoldRush Platform
  2. Set environment variable:
    export GOLDRUSH_API_KEY="your-api-key"

SDK Installation

TypeScript/JavaScript:

npm install @covalenthq/client-sdk

Python:

pip install covalent-api-sdk

Quick Start

TypeScript

import { GoldRushClient } from "@covalenthq/client-sdk";

const client = new GoldRushClient("YOUR_API_KEY");

// Get token balances
const response = await client.BalanceService.getTokenBalancesForWalletAddress(
  "eth-mainnet",
  "vitalik.eth"
);

console.log(response.data.items);

Python

from covalent import CovalentClient

client = CovalentClient("YOUR_API_KEY")

# Get token balances
response = client.balance_service.get_token_balances_for_wallet_address(
    "eth-mainnet",
    "vitalik.eth"
)

print(response.data.items)

What's Included

CovalentAgentSkill/
├── SKILL.md                              # Main skill instructions
├── README.md                             # This file
├── examples/
│   ├── typescript/
│   │   ├── foundational/
│   │   │   ├── wallet-balances.ts        # Token balance queries
│   │   │   ├── token-transfers.ts        # ERC20 transfer history
│   │   │   ├── transactions.ts           # Transaction fetching
│   │   │   ├── nfts.ts                   # NFT data & metadata
│   │   │   └── cross-chain.ts            # Multi-chain queries
│   │   └── streaming/
│   │       ├── ohlcv-tokens.ts           # Real-time price data
│   │       ├── new-dex-pairs.ts          # New pair detection
│   │       └── wallet-activity.ts        # Live wallet monitoring
│   └── python/
│       ├── wallet-balances.py
│       ├── transactions.py
│       ├── nfts.py
│       └── cross-chain.py
└── resources/
    ├── chains.md                         # Supported chains reference
    └── api-quick-reference.md            # Quick API reference

Use Cases

  • Wallets & Portfolio Trackers - Token balances with real-time prices
  • DeFi Dashboards - Transaction history and decoded events
  • NFT Galleries - NFT ownership, metadata, and traits
  • Trading Bots - Real-time price streams and new pair detection
  • Copy Trading - Live wallet activity monitoring
  • Tax & Accounting - Historical transactions with cost basis

API Coverage

Foundational API (REST)

  • Balance Service - Token balances, transfers, portfolio history
  • Transaction Service - TX history, details, summaries
  • NFT Service - NFT ownership, metadata, traits, market data
  • Base Service - Blocks, logs, chains, gas prices
  • Security Service - Token approvals, NFT approvals
  • Pricing Service - Historical token prices

Streaming API (WebSocket)

  • OHLCV Tokens Stream - Real-time price candles
  • OHLCV Pairs Stream - Trading pair price data
  • New DEX Pairs Stream - New token pair detection
  • Update Pairs Stream - Liquidity/volume updates
  • Wallet Activity Stream - Live transaction tracking

Links

License

MIT

About

Claude Code Skill for Colvalent Goldrush API

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published