Einstein — Blockchain Analytics via x402
Einstein provides 27 blockchain analytics services accessible via x402 micropayments (USDC on Base). Each query costs $0.25–$1.15 depending on complexity.
Quick Start
# 1. Install dependencies (manual step — the setup wizard will NOT run npm for you)
cd packages/project-einstein/openclaw-skill/einstein && npm install
# 2. Set your private key via environment variable (recommended)
export EINSTEIN_X402_PRIVATE_KEY=0x_your_private_key_here
# 3. Or run the interactive setup wizard
node scripts/einstein-setup.mjs
# 4. List all services (free)
node scripts/einstein.mjs services
# 5. Run a query (will prompt for payment confirmation)
node scripts/einstein.mjs top-movers --chain base --limit 10
Requirements:
- Node.js 18+
- Dependencies installed via
npm install(not auto-installed) - A dedicated wallet private key with USDC on Base network (do NOT use your main wallet)
- Set
EINSTEIN_X402_PRIVATE_KEYenvironment variable (preferred) or run setup with--save-config
Service Categories
| Tier | Price (Raw) | Price (+AI) | Services |
|---|---|---|---|
| Basic | $0.25 | $0.40 | Latest tokens, token chart |
| Standard | $0.40 | $0.55 | Top movers, top tokens, OHLCV, Virtuals, wallet holdings, holder concentration |
| Platform | $0.60 | $0.75 | Zora launches/volume, Pump.fun launches/volume/graduation, BSC alpha, liquidity shifts |
| Advanced | $0.85 | $1.00 | Whale intel, smart money, top traders, DEX capital, token sniping, Polymarket events |
| Comprehensive | $1.00 | $1.15 | Investment report, NFT analytics, MEV detection, arbitrage scanner, rug pull scanner, Polymarket compare |
Raw = structured data only. +AI = includes AI-generated analysis and insights (default).
Free Services
These commands are free and do not require x402 payment or a wallet key.
Epstein Files Search
Search 44,886+ DOJ-released Jeffrey Epstein documents (Jan 2026 release) via the DugganUSA public index.
# Search by name
node scripts/einstein.mjs epstein-search --query "Ghislaine Maxwell" --limit 10
# Search by topic
node scripts/einstein.mjs epstein-search --query "flight logs" --limit 20
# Search by location
node scripts/einstein.mjs epstein-search --query "Little St James"
| Flag | Description | Default |
|---|---|---|
--query <terms> | Search query (required) | — |
--limit <N> | Number of results (1-500) | 10 |
Usage Examples
Market Analysis
# Top movers on Base in the last 24 hours
node scripts/einstein.mjs top-movers --chain base --timeperiod 1d --limit 10
# Top tokens by market cap on Ethereum
node scripts/einstein.mjs top-tokens --chain ethereum --limit 20
# Latest deployed tokens with liquidity
node scripts/einstein.mjs latest-tokens --chain base --limit 15
Whale & Smart Money Intelligence
# Track whale accumulation on Ethereum
node scripts/einstein.mjs whale-intel --chain ethereum --limit 10 --timeperiod 7d
# Smart money leaderboard on Base
node scripts/einstein.mjs smart-money --chain base --limit 20 --timeperiod 7d
# Capital-intensive DEX traders
node scripts/einstein.mjs dex-capital --chain base --limit 10 --timeperiod 3d
Security & Risk Analysis
# Scan a token for rug pull risk
node scripts/einstein.mjs rug-scan --chain ethereum --token 0x1234...abcd
# Detect MEV/sandwich attacks
node scripts/einstein.mjs mev-detect --chain ethereum --limit 10 --timeperiod 1d
# Identify early snipers on a token
node scripts/einstein.mjs token-snipe --chain base --token 0x1234...abcd --limit 20
Launchpad Monitoring
# Latest Pump.fun launches on Solana
node scripts/einstein.mjs pump-launches --limit 15 --timeperiod 1d
# Pump.fun tokens about to graduate
node scripts/einstein.mjs pump-grads --limit 10
# Zora launches on Base
node scripts/einstein.mjs zora-launches --limit 10 --timeperiod 3d
# Virtuals Protocol agent tokens
node scripts/einstein.mjs virtuals --limit 10 --timeperiod 7d
Portfolio & Token Analysis
# Check wallet holdings
node scripts/einstein.mjs wallet --chain ethereum --wallet 0xd8dA...
# Token holder concentration
node scripts/einstein.mjs holders --chain base --token 0x1234... --limit 50
# Token price chart
node scripts/einstein.mjs chart --chain base --token 0x1234... --timeperiod 7d
# OHLCV data for technical analysis
node scripts/einstein.mjs ohlcv --chain base --token 0x1234... --timeperiod 30d
Advanced Reports
# Multi-chain investment report
node scripts/einstein.mjs investment-report --chains base,ethereum,bsc --limit 10 --timeperiod 7d
# Cross-chain arbitrage opportunities
node scripts/einstein.mjs arbitrage --chain ethereum --limit 10 --timeperiod 1d
# NFT collection analytics
node scripts/einstein.mjs nft-analytics --chain ethereum --limit 10 --timeperiod 7d
Prediction Markets
# Polymarket events (Polygon)
node scripts/einstein.mjs polymarket --limit 10 --timeperiod 7d
# Compare Polymarket API vs chain data
node scripts/einstein.mjs polymarket-compare --limit 10
How Payment Works
Einstein uses the x402 protocol — an HTTP-native micropayment standard. Payment is automatic:
- Your request hits Einstein's endpoint
- Server responds with HTTP 402 + payment challenge
- The skill signs a USDC TransferWithAuthorization (EIP-3009) using your private key
- Request is re-sent with the payment signature
- Coinbase CDP facilitator settles the USDC transfer on Base
- You receive the analytics data
No accounts, no API keys, no subscriptions. Just USDC on Base and a private key.
Options Reference
einstein.mjs (query CLI)
| Flag | Description | Default |
|---|---|---|
--chain <chain> | Blockchain network | base |
--limit <N> | Number of results (1-500) | 10 |
--timeperiod <period> | Time window: 1d, 3d, 7d, 30d | 7d |
--token <address> | Token contract address | — |
--wallet <address> | Wallet address | — |
--chains <c1,c2> | Comma-separated chains | — |
--raw | Data-only response (cheaper) | false |
--yes / -y | Skip payment confirmation prompt | false |
To skip the confirmation prompt globally, set EINSTEIN_AUTO_CONFIRM=true or add "autoConfirm": true to config.json.
einstein-setup.mjs (setup wizard)
| Flag | Description | Default |
|---|---|---|
--key <privateKey> | Private key (skips interactive prompt) | — |
--url <baseUrl> | Base URL for Einstein API | https://emc2ai.io |
--chain <chain> | Default blockchain network | base |
--save-config | Write config.json to disk (otherwise prints env var exports) | false |
Supported chains: base, ethereum, bsc, solana, arbitrum, polygon, optimism, zksync
Security Best Practices
Use a dedicated wallet. Create a separate wallet funded with a small amount of USDC for this skill. Do NOT use your primary wallet or any wallet holding significant funds.
Prefer environment variables over config.json. Environment variables (EINSTEIN_X402_PRIVATE_KEY) are not persisted to disk and are harder to accidentally commit to git. If you must use config.json (--save-config), restrict file permissions:
chmod 600 config.json
What gets signed. Each paid query signs an EIP-3009 TransferWithAuthorization message that authorizes a USDC transfer of the exact query price (shown before confirmation) from your wallet to the Einstein service address. The signature is single-use (unique nonce) and time-limited. No blanket approvals are granted.
Payment confirmation. By default, the CLI prompts before every paid query showing the exact cost. To skip the prompt for scripted/automated use, pass --yes / -y per-command or set EINSTEIN_AUTO_CONFIRM=true globally.
No auto-installed packages. The setup wizard does NOT run npm install automatically. You must install dependencies yourself so you can audit what is being installed.
No home directory scanning. Configuration is loaded only from environment variables and the skill-local config.json. No paths outside the skill directory are read.
Troubleshooting
"No private key configured"
Set EINSTEIN_X402_PRIVATE_KEY environment variable or run node scripts/einstein-setup.mjs --save-config.
"Payment rejected" / "Insufficient balance" Your wallet needs USDC on Base. Bridge via https://bridge.base.org. Use a dedicated wallet with a small balance.
"Cannot reach emc2ai.io" Check internet connection. The service may have temporary downtime.
"Unknown service"
Run node scripts/einstein.mjs services to see all available commands.
"Dependencies not installed"
Run npm install in the skill directory: cd packages/project-einstein/openclaw-skill/einstein && npm install
References
references/services-catalog.md— Full service catalog with parametersreferences/payment-guide.md— Detailed x402 payment protocol guidereferences/examples.md— Extended usage examples by category