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
• curl and jq installed on your system

Getting Your Arkham API Key

1. Go to Arkham Intelligence Platform
2. Create an account or sign in
3. Navigate to Settings > API Keys
4. Click Generate API Key
5. 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

1. Download or copy the .claude/skills/arkham-api/SKILL.md file
2. Place it in your project's .claude/skills/arkham-api/ directory
3. Optionally copy ARKHAM_API_DOCUMENTATION.md to 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": {
    "ARKHAM_API_KEY": "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
├── ARKHAM_API_DOCUMENTATION.md       # Detailed API reference
├── README.md                         # This file
├── LICENSE                           # MIT License
└── .gitignore

Security Notes

• Never commit your API key - The .gitignore is 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 curl and read-only file operations

Troubleshooting

"ARKHAM_API_KEY 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

1. Check the skill is in the correct directory
2. Verify the SKILL.md file has valid YAML frontmatter
3. Restart Claude Code

Contributing

Contributions are welcome! Please:

1. Fork this repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. 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

Use at your own risk. Always verify important blockchain data from multiple sources.

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!