onchain

# Onchain CLI

CLI for crypto portfolio tracking, market data, and CEX history.

## First-Time Setup (Required)

Before using most features, users must configure their API keys:

```bash
onchain setup
```

This interactive wizard helps configure:
- **Coinbase/Binance** - For CEX balances and trade history
- **DeBank** - For EVM wallet data (Ethereum, Polygon, Arbitrum, etc.)
- **Helius** - For Solana wallet data

**Without setup**: Only `onchain price` and `onchain markets` work (using free CoinGecko tier).

**Verify setup**: Run `onchain test` to check which providers are configured and working.

**Agent note**: If a command fails with "not configured" or "API key required", guide the user to run `onchain setup` first, then `onchain test` to verify.

## Invocation

```
onchain <command>
```

## Commands

### Market Data

```bash
onchain price <token>         # Token price (btc, eth, sol, etc.)
onchain markets               # Market overview with trending
onchain search <query>        # Search tokens by name or symbol
onchain gas                   # Current gas prices (Ethereum default)
onchain gas --chain polygon   # Gas prices for other EVM chains
```

### Wallet Data

```bash
onchain balance [address]           # Token balances (auto-detects EVM/Solana)
onchain balance --chain polygon     # Filter by chain
onchain history [address]           # Transaction history
onchain portfolio [address]         # Full portfolio with DeFi positions
```

### Transaction Lookup

```bash
onchain tx <hash>                   # Lookup transaction details (auto-detects chain)
onchain tx <hash> --chain base      # Specify chain explicitly
onchain tx <explorer-url>           # Paste block explorer URL directly
```

Supports EVM chains (Ethereum, Polygon, Base, Arbitrum, Optimism, BSC, Avalanche, Fantom) and Solana. Accepts raw hashes or explorer URLs (etherscan.io, basescan.org, solscan.io, etc.).

#### Example Output
```
Transaction Details

✓ Status: SUCCESS
  Hash:  0xd757...5f31...

# @cyberdrk/onchain

CLI for crypto portfolio tracking, market data, and CEX history. Designed for both human use and AI agent integration.

## Installation

```bash
npm install -g @cyberdrk/onchain
```

Or run directly with npx:
```bash
npx @cyberdrk/onchain price btc
```

## Quick Start

```bash
# Check token prices
onchain price btc
onchain price eth sol matic

# View wallet balances (auto-detects EVM/Solana)
onchain balance 0x1234...5678

# CEX balances
onchain coinbase balance
onchain binance balance

# Market overview
onchain markets

# Prediction markets
onchain polymarket trending
```

## Commands

### Market Data
```bash
onchain price <token>           # Token price with 24h change
onchain markets                 # Market overview with trending coins
```

### Wallet Data
```bash
onchain balance <address>       # Token balances (EVM or Solana)
onchain history <address>       # Transaction history
onchain portfolio <address>     # Full portfolio with DeFi positions
```

### CEX Data
```bash
onchain coinbase balance        # Coinbase account balances
onchain coinbase history        # Trade history
onchain binance balance         # Binance account balances
onchain binance history         # Trade history
```

### Prediction Markets
```bash
onchain polymarket trending     # Trending markets
onchain polymarket search <q>   # Search markets
onchain polymarket view <slug>  # Market details
```

### Configuration
```bash
onchain setup                   # Interactive API key setup
onchain config                  # View current configuration
onchain test                    # Test all configured providers
```

## Configuration

Run `onchain setup` for interactive configuration, or set environment variables:

| Feature | Environment Variable | Provider |
|---------|---------------------|----------|
| EVM wallets | `DEBANK_API_KEY` | [DeBank Cloud](https://cloud.debank.com/) |
| Solana wallets | `HELIUS_API_KEY` | [Helius](https://helius.xyz/) |
| Coinbase | `COINBASE_API...