Onchain CLI
CLI for crypto portfolio tracking, market data, and CEX history.
Invocation
onchain <command>
Commands
Market Data
onchain price <token> # Token price (btc, eth, sol, etc.)
onchain markets # Market overview with trending
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
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
onchain polymarket trending # Trending markets
onchain polymarket search <query> # Search markets
onchain polymarket view <slug> # View market details
Configuration
onchain setup # Interactive setup wizard
onchain config # View current config
onchain config wallet add <name> <address>
onchain config wallet set-default <name>
Global Options
--json- Output as JSON (agent-friendly)--plain- Disable colors and emoji--timeout <ms>- Request timeout
Configuration
Config file: ~/.config/onchain/config.json5
Required API Keys
| Feature | API Key | Get Key |
|---|---|---|
| EVM wallets | DEBANK_API_KEY |
DeBank |
| Solana wallets | HELIUS_API_KEY |
Helius |
| Coinbase CEX | COINBASE_API_KEY + COINBASE_API_SECRET |
Coinbase |
| Binance CEX | BINANCE_API_KEY + BINANCE_API_SECRET |
Binance |
Optional API Keys
| Feature | API Key | Notes |
|---|---|---|
| Market data | COINGECKO_API_KEY |
Free tier works, Pro for higher limits |
| Market fallback | COINMARKETCAP_API_KEY |
Alternative market data source |
Examples
Get Bitcoin price
onchain price btc
Check wallet balance
onchain balance 0x1234...5678
View portfolio with DeFi positions
onchain portfolio main # Uses saved wallet named "main"
Get trending prediction markets
onchain polymarket trending -n 5
JSON output for scripts
onchain --json price eth | jq '.priceUsd'
Supported Chains
EVM (via DeBank)
Ethereum, BNB Chain, Polygon, Arbitrum, Optimism, Avalanche, Base, zkSync Era, Linea, Scroll, Blast, Mantle, Gnosis, Fantom, Celo, and more.
Solana (via Helius)
Full Solana mainnet support including SPL tokens and NFTs.
Agent Integration
This CLI is designed for agent use. Key patterns:
- Always use
--jsonfor programmatic access - Check exit codes - 0 for success, 1 for error
- Use saved wallets - Configure once with
onchain setup, reference by name - Rate limiting - APIs have rate limits, add delays between rapid calls
Example Agent Usage
# Get portfolio value
VALUE=$(onchain --json portfolio main | jq -r '.totalValueUsd')
# Get price with change
onchain --json price btc | jq '{price: .priceUsd, change24h: .priceChange24h}'
# Check if market is bullish
CHANGE=$(onchain --json markets | jq '.marketCapChange24h')
