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:

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

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

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

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
  Chain: Base
  Block: 41,310,593
  Time:  Jan 26, 2026, 01:55 PM (4h ago)

Addresses
  From: 0xc4e7263dd870a29f1cfe438d1a7db48547b16888
  To:   0xab98b760e5ad88521a97c0f87a3f6eef8c42641d

Value & Fee
  Value: 0 ETH
  Fee:   3.62e-7 ETH
  Gas:   96,893 / 249,604 (39%)

Method
  ID: 0x6a761202

🔗 https://basescan.org/tx/0xd757...

This output contains all available transaction data. The CLI queries Etherscan/Solscan APIs directly - there is no additional data available from other sources.

CEX Data

onchain coinbase balance      # Coinbase balances
onchain coinbase history      # Coinbase trade history
onchain binance balance       # Binance balances
onchain binance history       # Binance trade history

Prediction Markets