command-reference.md

Command Reference

Prerequisites

Set up API keys in .env:

ETHERSCAN_API_KEY=your_etherscan_api_key
COVALENT_API_KEY=your_covalent_api_key
HELIUS_API_KEY=your_helius_api_key
BYBIT_API_KEY=your_bybit_api_key
BYBIT_API_SECRET=your_bybit_api_secret

Commands

Analyze Blockchain Address

pnpm analyze <address> [blockchain] [assetId]

Parameters:

• address - Blockchain address to analyze
• blockchain - Optional, defaults to 'ethereum'
  • Supported: ethereum, avalanche, base, arbitrum, solana
• assetId - Optional, track specific asset origin

What it does:

1. Shows all token balances (native + ERC-20/SPL)
2. Displays complete transaction history
3. Shows first activity date and duration
4. Tracks asset origin when assetId provided

Analyze Exchange Account

pnpm analyze exchange <exchange>

Parameters:

• exchange - Exchange name
  • Supported: bybit

What it does:

1. Authenticates with exchange API using credentials from .env
2. Retrieves full account history from registration date
3. Imports all spot trades, deposits, and withdrawals
4. Shows current exchange balances
5. Saves all data to database with exchange source marking

Examples

Blockchain Analysis

# Ethereum (default)
pnpm analyze 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

# Other blockchains
pnpm analyze 0xYourAddress avalanche
pnpm analyze 0xYourAddress base
pnpm analyze 0xYourAddress arbitrum
pnpm analyze SolanaAddress solana

Asset Tracking

# Track native tokens
pnpm analyze 0xYourAddress ethereum ethereum
pnpm analyze 0xYourAddress avalanche avax
pnpm analyze SolanaAddress solana sol

# Track specific tokens
pnpm analyze 0xYourAddress ethereum usdt
pnpm analyze 0xYourAddress avalanche joe
pnpm analyze 0xYourAddress base usdc
pnpm analyze 0xYourAddress arbitrum arb
pnpm analyze SolanaAddress solana bonk

Exchange Analysis

# Import Bybit trading data
pnpm analyze exchange bybit

# Alternative with explicit credentials
BYBIT_API_KEY=your_key BYBIT_API_SECRET=your_secret pnpm analyze exchange bybit