A Claude Code skill that integrates Arkham Intelligence API for on-chain analytics. Track whale movements, analyze wallet holdings, monitor smart money positions, and investigate token flows across 10+ blockchains using natural language.
Arkham Intelligence API Skill for Claude Code
Unofficial community project - This is not affiliated with, endorsed by, or officially supported by Arkham Intelligence or Anthropic.
A Claude Code skill that integrates the Arkham Intelligence API for blockchain analytics directly into your AI coding assistant. Track whales, analyze wallets, monitor smart money & investigate token flows using natural language.
What is this?
This repository provides a Claude Code skill that enables Claude to interact with the Arkham Intelligence API. With this skill, you can ask Claude to:
- Analyze wallet addresses and their holdings
- Track whale movements and large transfers
- Investigate token holders and smart money positions
- Monitor trending tokens and market flows
- Research entities like exchanges, market makers, and funds
- Get real-time blockchain intelligence across 10+ chains
Prerequisites
- Claude Code CLI installed and configured
- An Arkham Intelligence API key
curlandjqinstalled on your system
Getting Your Arkham API Key
- Go to Arkham Intelligence Platform
- Create an account or sign in
- Navigate to Settings > API Keys
- Click Generate API Key
- Copy your API key (you won't be able to see it again!)
Note: Arkham API has different tiers with varying rate limits. Check their API documentation for details.
Installation
Option 1: Clone to your project (Recommended)
Clone this repository into your project's .claude/skills/ directory:
# Navigate to your project
cd your-project
Create the skills directory if it doesn't exist
mkdir -p .claude/skills
Clone this repo as a skill
git clone https://github.com/Vyntral/arkham-intelligence-claude-skill .claude/skills/arkham-api
Option 2: Install globally for all projects
Clone to your personal Claude Code skills directory:
# Create global skills directory
mkdir -p ~/.claude/skills
Clone this repo
git clone https://github.com/Vyntral/arkham-intelligence-claude-skill ~/.claude/skills/arkham-api
Option 3: Manual installation
- Download or copy the
.claude/skills/arkham-api/SKILL.mdfile - Place it in your project's
.claude/skills/arkham-api/directory - Optionally copy
ARKHAMAPIDOCUMENTATION.mdto the same location for detailed API reference
Configuration
Step 1: Set up your API key
Copy the example settings file and add your API key:
# For project-specific configuration
cp .claude/settings.local.json.example .claude/settings.local.json
Edit and add your key
nano .claude/settings.local.json
Or add to your global Claude Code settings (~/.claude/settings.json):
{
"env": {
"ARKHAMAPIKEY": "your-api-key-here"
}
}
Step 2: Configure permissions (optional)
The skill requires permissions to make curl requests. Add to your settings:
{
"permissions": {
"allow": [
"Bash(curl:*)",
"Skill(arkham-api)"
]
}
}
Step 3: Restart Claude Code
After adding your API key, restart Claude Code for changes to take effect.
Usage
Once installed, you can invoke the skill by:
Direct invocation
/arkham-api analyze the top holders of PEPE token
Natural language (Claude will auto-detect)
"What wallets hold the most ETH?"
"Track transfers from Binance in the last 24 hours"
"Who are the top token holders for $DOGE?"
"Find smart money movements on Solana"
Example Queries
| Query Type | Example | |------------|---------| | Wallet Analysis | "Analyze the holdings of address 0x..." | | Entity Research | "Show me Wintermute's current portfolio" | | Token Holders | "Who are the top 10 holders of PEPE?" | | Whale Tracking | "Find transfers over $1M in the last 24h" | | Market Intelligence | "What tokens are trending right now?" | | Smart Money | "What tokens is Jump Trading holding?" |
Supported Chains
The Arkham API supports the following blockchains:
- Ethereum
- Bitcoin
- Solana
- Polygon
- Arbitrum One
- Base
- Optimism
- Avalanche
- BNB Smart Chain (BSC)
- TRON
- TON
Rate Limits
| Endpoint Type | Rate Limit | |--------------|------------| | Standard endpoints | 20 requests/second | | Heavy endpoints* | 1 request/second |
Heavy endpoints include: /transfers, /swaps, /counterparties/, /token/top_flow/, /token/volume/
Repository Structure
arkham-intelligence-claude-skill/
โโโ .claude/
โ โโโ skills/
โ โ โโโ arkham-api/
โ โ โโโ SKILL.md # Main skill instructions
โ โโโ settings.local.json # Your local config (gitignored)
โ โโโ settings.local.json.example # Template for settings
โโโ ARKHAMAPIDOCUMENTATION.md # Detailed API reference
โโโ README.md # This file
โโโ LICENSE # MIT License
โโโ .gitignore
Security Notes
- Never commit your API key - The
.gitignoreis configured to exclude.claude/settings.local.json - Store API keys in user-level settings (
~/.claude/settings.json) for personal keys - Use project-level settings (
.claude/settings.local.json) for project-specific keys - The skill only has access to
curland read-only file operations
Troubleshooting
"ARKHAMAPIKEY not found"
Make sure you've added your API key to settings and restarted Claude Code."Rate limit exceeded"
The API has rate limits. Wait a few seconds and try again, or use pagination for large queries."Empty response from /swaps endpoint"
The swaps endpoint availability depends on your API tier. This is a known limitation.Skill not appearing
- Check the skill is in the correct directory
- Verify the SKILL.md file has valid YAML frontmatter
- Restart Claude Code
Contributing
Contributions are welcome! Please:
- Fork this repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Disclaimer
This is an unofficial, community-maintained project. It is:
- NOT affiliated with or endorsed by Arkham Intelligence
- NOT affiliated with or endorsed by Anthropic
- Provided "as is" without warranty of any kind
- Subject to Arkham Intelligence's Terms of Service and API usage policies
License
This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgments
- Arkham Intelligence for their excellent blockchain analytics platform
- Anthropic for Claude and Claude Code
- The Claude Code community
Questions or issues? Open an issue on GitHub!