Package Exports

@cyberdrk/onchain
@cyberdrk/onchain/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@cyberdrk/onchain) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@cyberdrk/onchain

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

Installation

npm install -g @cyberdrk/onchain

Or run directly with npx:

npx @cyberdrk/onchain price btc

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 wallets	`DEBANK_API_KEY`	DeBank Cloud
Solana wallets	`HELIUS_API_KEY`	Helius
Coinbase	`COINBASE_API_KEY_ID` + `COINBASE_API_KEY_SECRET`	Coinbase CDP
Binance	`BINANCE_API_KEY` + `BINANCE_API_SECRET`	Binance
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 (via DeBank): Ethereum, BNB Chain, Polygon, Arbitrum, Optimism, Avalanche, Base, zkSync Era, Linea, Scroll, Blast, Mantle, and 60+ more.

Solana (via Helius): 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