# Arkham Api

> Interact with Arkham Intelligence API for blockchain analytics - wallet analysis, transfers tracking, token flows, entity intelligence, portfolio analysis, and on-chain investigations. Use when analyzing crypto addresses, tracking whale movements, investigating transactions, or getting blockchain intelligence.

- **Type:** Skill
- **Install:** `agentstack add skill-vyntral-arkham-intelligence-claude-skill-arkham-api`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Vyntral](https://agentstack.voostack.com/s/vyntral)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Vyntral](https://github.com/Vyntral)
- **Source:** https://github.com/Vyntral/arkham-intelligence-claude-skill/tree/main/.claude/skills/arkham-api

## Install

```sh
agentstack add skill-vyntral-arkham-intelligence-claude-skill-arkham-api
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Arkham Intelligence API Skill

## Configuration

**API Key** must be set in Claude Code settings:

```json
// ~/.claude/settings.json
{
  "env": {
    "ARKHAM_API_KEY": "your_api_key_here"
  }
}
```

Restart Claude Code after adding the key.

## Making API Calls

**Important**: Always use this pattern for API calls:

```bash
KEY=$(printenv ARKHAM_API_KEY)
curl -s "https://api.arkm.com/ENDPOINT" -H "API-Key: $KEY" | jq .
```

## Rate Limits

- **Standard endpoints**: 20 req/sec
- **Heavy endpoints** (1 req/sec): `/transfers`, `/swaps`, `/counterparties/*`, `/token/top_flow/*`, `/token/volume/*`

## Quick Reference

### Intelligence
```bash
# Address info
curl -s "https://api.arkm.com/intelligence/address/0x...?chain=ethereum" -H "API-Key: $KEY" | jq .

# Entity info (binance, wintermute, jump-trading, etc.)
curl -s "https://api.arkm.com/intelligence/entity/wintermute" -H "API-Key: $KEY" | jq .
```

### Balances & Portfolio
```bash
# Entity balances
curl -s "https://api.arkm.com/balances/entity/wintermute" -H "API-Key: $KEY" | jq .

# Address balances
curl -s "https://api.arkm.com/balances/address/0x...?chains=ethereum,solana" -H "API-Key: $KEY" | jq .
```

### Transfers
```bash
# Recent transfers from entity
curl -s "https://api.arkm.com/transfers?base=binance&flow=out&timeLast=24h&limit=20" -H "API-Key: $KEY" | jq .

# Large transfers
curl -s "https://api.arkm.com/transfers?usdGte=1000000&timeLast=24h&limit=50" -H "API-Key: $KEY" | jq .
```

### Token Analysis
```bash
# Top holders
curl -s "https://api.arkm.com/token/holders/pepe?groupByEntity=true" -H "API-Key: $KEY" | jq .

# Trending tokens
curl -s "https://api.arkm.com/token/trending" -H "API-Key: $KEY" | jq .

# Top tokens by volume
curl -s "https://api.arkm.com/token/top?timeframe=24h&orderByAgg=volume&orderByDesc=true&orderByPercent=false&from=0&size=20" -H "API-Key: $KEY" | jq .

# Token flows (inflows/outflows)
curl -s "https://api.arkm.com/token/top_flow/ethereum?timeLast=24h" -H "API-Key: $KEY" | jq .
```

### Market Data
```bash
# Network status (prices, volume, market cap)
curl -s "https://api.arkm.com/networks/status" -H "API-Key: $KEY" | jq .

# Altcoin index (altseason indicator)
curl -s "https://api.arkm.com/marketdata/altcoin_index" -H "API-Key: $KEY" | jq .
```

## Practical Use Cases

### 1. Find Smart Money / Market Makers
```bash
KEY=$(printenv ARKHAM_API_KEY)

# Get market maker info
curl -s "https://api.arkm.com/intelligence/entity/wintermute" -H "API-Key: $KEY" | jq .

# Check their holdings (balances organized by chain)
cat > /tmp/flatten_balances.jq  /tmp/whale_holdings.jq  100000) | {symbol, usd}] | sort_by(-.usd)
EOF
curl -s "https://api.arkm.com/balances/entity/wintermute" -H "API-Key: $KEY" | jq -f /tmp/whale_holdings.jq
```

### 3. Track Large Movements
```bash
KEY=$(printenv ARKHAM_API_KEY)

# Whale transfers last 24h (note: use historicalUSD, not unitValueUsd)
curl -s "https://api.arkm.com/transfers?usdGte=5000000&timeLast=24h&limit=50" -H "API-Key: $KEY" \
  | jq '.transfers[] | {from: .fromAddress.arkhamEntity.name, to: .toAddress.arkhamEntity.name, usd: .historicalUSD, token: .tokenSymbol}'
```

### 4. Token Holder Analysis
```bash
KEY=$(printenv ARKHAM_API_KEY)

# Who holds this token? (entityTopHolders organized by chain)
cat > /tmp/token_holders.jq  /tmp/accumulators.jq  /tmp/sellers.jq  /tmp/hacker_holdings.jq  /tmp/wm.json
curl -s "https://api.arkm.com/balances/entity/jump-trading" -H "API-Key: $KEY" > /tmp/jt.json

# Compare totals and top holdings
cat > /tmp/portfolio_summary.jq  /tmp/cex_flows.jq  /tmp/network.jq  /tmp/filter.jq << 'EOF'
[.[] | select(.address.arkhamEntity.name != null) | {
  entity: (.address.arkhamEntity.name // "unknown"),
  type: .address.arkhamEntity.type,
  net_flow: (.inUSD - .outUSD)
}] | sort_by(-.net_flow)
EOF

curl -s "https://api.arkm.com/token/top_flow/ethereum?timeLast=7d" \
  -H "API-Key: $KEY" | jq -f /tmp/filter.jq

# ✅ For simple cases, use alternative syntax:
curl ... | jq 'select(.name | . != null)'  # wrap in subexpression
```

### Response Structure Variations

**⚠️ CRITICAL**: Most endpoints return data organized by chain, NOT flat arrays!

| Endpoint | Structure | How to Access |
|----------|-----------|---------------|
| `/balances/entity` | `{balances: {chain: [...]}, totalBalance: {chain: num}}` | `.balances.ethereum[]` or flatten with `to_entries` |
| `/token/holders` | `{entityTopHolders: {chain: [...]}}` | `.entityTopHolders.solana[]` |
| `/token/top_flow` | `[{address: {arkhamEntity}, inUSD, outUSD}]` | Direct array, entity in `.address.arkhamEntity` |
| `/counterparties` | `{chain: [...]}` | `.ethereum[]` (no wrapper key) |
| `/transfers` | `{transfers: [...]}` | `.transfers[]`, USD in `.historicalUSD` |
| `/token/trending` | `[{name, symbol, identifier}]` | Direct array, flat structure |
| `/token/top` | `{tokens: [...], total}` | `.tokens[]`, requires `orderByPercent` param |
| `/networks/status` | `{chain: {price, volume, ...}}` | `.ethereum.price`, chain-organized |
| `/loans/entity` | `{balances, entities, totalPositions}` | DeFi positions by protocol |

**Key Fields:**
- Transfers: `historicalUSD` (not `unitValueUsd`)
- Token holders: `.entity.name` (not `.arkhamEntity.name`)
- Balances: organized by chain, `totalBalance` is object not number

**Tip**: Always run `jq 'keys'` or `jq 'type'` first to explore unknown structures.

---

## All Endpoints Reference

For detailed parameters, see `ARKHAM_API_DOCUMENTATION.md`

| Category | Endpoint | Note |
|----------|----------|------|
| **Health** | `GET /health` | |
| | `GET /chains` | |
| **Transfers** | `GET /transfers` | HEAVY |
| | `GET /transfers/histogram` | HEAVY |
| | `GET /transfers/histogram/simple` | HEAVY |
| | `GET /swaps` | HEAVY, works |
| **Transaction** | `GET /tx/{hash}` | |
| **Intelligence** | `GET /intelligence/address/{address}` | |
| | `GET /intelligence/address/{address}/all` | Multi-chain |
| | `GET /intelligence/address_enriched/{address}` | With tags/predictions |
| | `GET /intelligence/address_enriched/{address}/all` | |
| | `GET /intelligence/entity/{entity}` | |
| | `GET /intelligence/entity/{entity}/summary` | |
| | `GET /intelligence/entity_predictions/{entity}` | ML predictions |
| | `GET /intelligence/contract/{chain}/{address}` | |
| | `GET /intelligence/token/{id}` | By CoinGecko ID |
| | `GET /intelligence/token/{chain}/{address}` | By contract |
| **Clusters & Tags** | `GET /cluster/{id}/summary` | |
| | `GET /tag/{id}/params` | |
| | `GET /tag/{id}/summary` | |
| **History** | `GET /history/entity/{entity}` | |
| | `GET /history/address/{address}` | |
| **Portfolio** | `GET /portfolio/entity/{entity}?time={ms}` | Snapshot |
| | `GET /portfolio/address/{address}?time={ms}` | |
| | `GET /portfolio/timeSeries/entity/{entity}` | Daily series |
| | `GET /portfolio/timeSeries/address/{address}` | |
| **Token** | `GET /token/top` | By exchange movements |
| | `GET /token/holders/{pricing_id}` | |
| | `GET /token/holders/{chain}/{address}` | |
| | `GET /token/trending` | |
| | `GET /token/trending/{id}` | |
| | `GET /token/top_flow/{id}` | HEAVY |
| | `GET /token/top_flow/{chain}/{address}` | HEAVY |
| | `GET /token/volume/{id}` | HEAVY |
| | `GET /token/volume/{chain}/{address}` | HEAVY |
| | `GET /token/balance/{id}` | |
| | `GET /token/balance/{chain}/{address}` | |
| **Balances** | `GET /balances/address/{address}` | |
| | `GET /balances/entity/{entity}` | |
| **Loans** | `GET /loans/address/{address}` | DeFi positions |
| | `GET /loans/entity/{entity}` | |
| **Counterparties** | `GET /counterparties/address/{address}` | HEAVY |
| | `GET /counterparties/entity/{entity}` | HEAVY |
| **Flow** | `GET /flow/address/{address}` | USD flows |
| | `GET /flow/entity/{entity}` | |
| **Networks** | `GET /networks/status` | |
| | `GET /networks/history/{chain}` | |
| **Market** | `GET /marketdata/altcoin_index` | |
| **User** | `GET /user/entities` | |
| | `GET /user/entities/{id}` | |
| | `GET /user/labels` | |
| | `POST /user/labels` | |
| **WebSocket** | `wss://api.arkm.com/ws/transfers` | Real-time |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Vyntral](https://github.com/Vyntral)
- **Source:** [Vyntral/arkham-intelligence-claude-skill](https://github.com/Vyntral/arkham-intelligence-claude-skill)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-vyntral-arkham-intelligence-claude-skill-arkham-api
- Seller: https://agentstack.voostack.com/s/vyntral
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.