@skillhq/onchain

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

Installation

Install the skill for your AI coding agent:

npx skills add https://github.com/skillhq/onchain --skill onchain

Install the CLI globally:

npm install -g @skillhq/onchain

Then configure your API keys:

onchain setup

This interactive wizard walks you through configuring Zerion (recommended), Coinbase, Binance, and other providers.

Quick Start

# 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

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

Wallet Data

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

CEX Data

onchain coinbase balance        # Coinbase account balances
onchain coinbase history        # Trade history
onchain binance balance         # Binance account balances
onchain binance history         # Trade history

Prediction Markets

onchain polymarket trending     # Trending markets
onchain polymarket search <q>   # Search markets
onchain polymarket view <slug>  # Market details

Configuration

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 + Solana wallets | ZERION_API_KEY | Zerion (recommended) | | Coinbase | COINBASE_API_KEY_ID + COINBASE_API_KEY_SECRET | Coinbase CDP | | Binance | BINANCE_API_KEY + BINANCE_API_SECRET | Binance | | EVM wallets (fallback) | DEBANK_API_KEY | DeBank Cloud | | Solana wallets (fallback) | HELIUS_API_KEY | Helius | | Market data | COINGECKO_API_KEY | CoinGecko (optional) | | Market fallback | COINMARKETCAP_API_KEY | CoinMarketCap (optional) |

Config file locations:

• Global: ~/.config/onchain/config.json5
• Local: ./.onchainrc.json5

Global Options

--json              # Output as JSON (for scripting/agents)
--plain             # Disable colors and emoji
--no-color          # Disable colors only
--timeout <ms>      # Request timeout in milliseconds

Agent Integration

This CLI is designed for AI agent use with --json output:

# Get portfolio value
onchain --json portfolio 0x123... | jq '.totalValueUsd'

# Check if market is up
onchain --json markets | jq '.marketCapChange24h > 0'

# Get specific token price
onchain --json price eth | jq '{price: .priceUsd, change: .priceChange24h}'

Exit codes: 0 for success, 1 for errors.

Supported Chains

EVM + Solana (via Zerion): Ethereum, BNB Chain, Polygon, Arbitrum, Optimism, Avalanche, Base, zkSync Era, Linea, Scroll, Blast, Mantle, Solana, and more. Single API key covers all chains.

EVM (via DeBank, fallback): Same EVM chains, requires separate DeBank API key.

Solana (via Helius, fallback): Full mainnet support including SPL tokens and NFTs.

Development

pnpm install
pnpm run dev price btc    # Run without building
pnpm run build            # Build TypeScript
pnpm run test             # Run tests
pnpm run lint             # Lint code

License

MIT