Crypto Analytics

Overview

A comprehensive multi-chain blockchain analysis tool using live API data:

• - EVM networks: 60+ chains via unified Etherscan V2 (Ethereum, Sepolia testnet, BSC, Polygon, Arbitrum, Base, Optimism, Avalanche, etc.)
• Bitcoin: Via Blockchair API
• Solana: Balance via public RPC (tx history requires external service)
• Built-in rate limiting and 5-minute caching
• No credentials needed for basic usage (API key increases Etherscan limits)

All commands return JSON with optional human-readable formatting.

---

Privacy & Data Handling

This skill respects your privacy and operates transparently:

• - External data collection: None. Only standard blockchain APIs receive your queries:

- api.etherscan.io (Etherscan V2) - blockchair.com (Blockchair) - Public Solana RPC endpoints

• - Local caching: API responses are cached for 5 minutes to respect rate limits. Cache files are stored in ~/.openclaw/cache/crypto-analytics/api_responses/ and may contain queried addresses, transaction hashes, and other public blockchain data you requested. Files are automatically expired and can be manually deleted. This data never leaves your machine.
• Environment variables: Optionally reads ETHERSCAN_API_KEY from a .env file located in the OpenClaw workspace root. No other environment variables are accessed.
• No subprocesses or dynamic code execution: Pure Python with requests library only.

You can audit the source code in scripts/crypto_api.py – it's straightforward HTTP + JSON.

---

Configuration (Optional)

Set ETHERSCAN_API_KEY to increase rate limits (free tier: 5 calls/sec). Get a key from https://etherscan.io/apis

CODEBLOCK0

Core Commands

balance <address> [chain]

Get native token balance for a wallet.

Parameters:

• - address - Blockchain address
• INLINECODE10 (optional) - Chain identifier. Auto-detects from address format if omitted.

- EVM: ethereum, sepolia, bsc, polygon, arbitrum, base, optimism, avalanche, and more
- Non-EVM: bitcoin, INLINECODE20

Example:
CODEBLOCK1

Output:
CODEBLOCK2

transactions <address> [chain] [limit=20]

Get recent transaction history.

Parameters:

• - address - Wallet address
• INLINECODE23 (optional) - Chain identifier (auto-detected if omitted)
• INLINECODE24 (optional) - Maximum transactions to return (default 20, max 100)

Example:
CODEBLOCK3

Output:
CODEBLOCK4

tx <txhash> <chain>

Get full transaction details.

Parameters:

• - txhash - Transaction hash
• INLINECODE27 - Chain identifier (required)

Example:
CODEBLOCK5

Output:
CODEBLOCK6

validate <address>

Check address validity and detect chain.

Parameters:

• - address - Address to validate

Example:
CODEBLOCK7

Output:
CODEBLOCK8

chains

List all supported blockchains with their specs.

Example:
CODEBLOCK9

gas [chain=ethereum]

Get current gas price estimates including Safe, Standard, and Fast rates, plus base fee (EIP-1559).

Parameters:

• - chain (optional) - Chain identifier (default: ethereum)

Example:
CODEBLOCK10

Output:
CODEBLOCK11

token <address> <token_contract> [chain]

Get ERC-20 token balance for a specific token contract, with symbol and formatted human-readable value.

Parameters:

• - address - Wallet address
• INLINECODE35 - ERC-20 token contract address
• INLINECODE36 (optional) - Chain identifier (auto-detected if omitted)

Example:
CODEBLOCK12

Output:
CODEBLOCK13

tokens <address> [chain] [limit=20]

Get all ERC-20 token balances for a wallet by auto-discovering tokens from recent transfer history. Returns non-zero balances with symbols and decimals.

Parameters:

• - address - Wallet address
• INLINECODE39 (optional) - Chain identifier (auto-detected if omitted)
• INLINECODE40 (optional) - Maximum number of tokens to check (default 20)

Example:
CODEBLOCK14

Output:
CODEBLOCK15

spl-tokens <owner>

Get SPL token accounts for a Solana wallet. Returns mint addresses and token amounts (human-readable).

Parameters:

• - owner - Solana wallet address (Base58)

Example:
CODEBLOCK16

Output:
CODEBLOCK17

When to Use This Skill

Use crypto-analytics when you need to:

• - Check wallet balances across multiple blockchains
• Investigate wallet activity and transaction patterns
• Look up specific transaction details
• Validate blockchain addresses
• Determine which chains are supported
• Integrate live blockchain data into OpenClaw automations

Example Scenarios

"Check my ETH balance"
balance 0x... ethereum or auto-detect if address starts with 0x

"How much BNB do I have on BSC?"
INLINECODE45

"Show me recent transactions for this Bitcoin address"
INLINECODE46

"Is this a valid address and what chain is it on?"
INLINECODE47

"What chains do you support?"
INLINECODE48

"Get details for tx 0xabc... on Arbitrum"
INLINECODE49

"Check my USDC balance on Ethereum"
INLINECODE50

"Show all tokens I have on Ethereum"
INLINECODE51

"What's the current gas price on Arbitrum?"
INLINECODE52

Implementation Notes

API Providers

• - Etherscan V2: Unified endpoint for 60+ EVM chains. Free tier: ~5 calls/sec, 5k-100k/day depending on chain. API key significantly increases limits.
• Blockchair: Bitcoin, Litecoin, Dogecoin, etc. Free: 100 req/min, 4k/day.
• Solana RPC: Public endpoints (rate-limited) for balances only.

Caching & Rate Limiting

• - TTL: 300 seconds (5 minutes)
• Cache location: INLINECODE53
• Rate delays: Enforced to stay within free tier limits
• Batching: Multiple queries in same session use cache

Configuration

Set API keys in .env:

CODEBLOCK18

Key optional for low-volume usage but recommended.

See references/api_index.md for full API documentation and references/chains.md for chain specifications.

Limitations & Future

Current limitations:

• - Solana transaction history requires specialized indexer (Solscan API)
• Solana token metadata (symbol, name) not available; only mint addresses are shown
• No batch multi-address queries
• Free tier rate limits apply

Planned enhancements:

• - Transaction tracing and money flow analysis
• Contract ABI decoding for read calls
• Additional chain-specific features
• Enhanced Solana token metadata (via token list)

Resources

This skill bundles useful reference material:

• - references/chains.md - Chain specifications, address formats, explorers
• INLINECODE58 - API endpoints, parameters, examples

These files are loaded into context only when needed.