onchainCLI for crypto portfolio tracking, market data, CEX history, and transaction lookups. Use when the user asks about crypto prices, wallet balances, portfolio values, Coinbase/Binance holdings, Polymarket predictions, or transaction details.
Install via ClawdBot CLI:
clawdbot install arein/onchainCLI for crypto portfolio tracking, market data, and CEX history.
Before using most features, users must configure their API keys:
onchain setupThis interactive wizard helps configure:
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.
onchain <command>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 chainsonchain 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 positionsonchain tx <hash> # Lookup transaction details (auto-detects chain)
onchain tx <hash> --chain base # Specify chain explicitly
onchain tx <explorer-url> # Paste block explorer URL directlySupports 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.).
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.
onchain coinbase balance # Coinbase balances
onchain coinbase history # Coinbase trade history
onchain binance balance # Binance balances
onchain binance history # Binance trade historyonchain polymarket tags # List all available tags/categories
onchain polymarket tags --popular # Show popular tags by market count
onchain polymarket trending # Trending markets (respects config filters)
onchain polymarket trending --all # Show all markets (ignore config filters)
onchain polymarket trending --exclude sports,nfl # Exclude specific tags
onchain polymarket trending --include crypto,ai # Only show specific tags
onchain polymarket search <query> # Search markets (respects config filters)
onchain polymarket view <slug> # View market details
onchain polymarket sentiment <topic> # Analyze market sentiment for a topicSentiment analysis: Analyzes prediction markets to determine bullish/bearish expectations:
onchain polymarket sentiment fed # Fed rate expectations
onchain polymarket sentiment bitcoin # Bitcoin market sentiment
onchain polymarket sentiment ai # AI-related predictions
onchain polymarket sentiment trump # Political sentiment
onchain polymarket sentiment fed --json # JSON output for agentsTag filtering: Configure default excludes in ~/.config/onchain/config.json5:
{
"polymarket": {
"excludeTags": ["sports", "nfl", "nba", "mlb"],
"includeTags": [] // empty = all non-excluded
}
}onchain setup # Interactive setup wizard
onchain config # View current config
onchain config wallet add <name> <address>
onchain config wallet set-default <name>--json - Output as JSON (agent-friendly)--plain - Disable colors and emoji--timeout - Request timeoutConfig file: ~/.config/onchain/config.json5
| 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 |
| 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 |
| EVM tx lookup | ETHERSCAN_API_KEY | For onchain tx on EVM chains |
| Solana tx lookup | SOLSCAN_API_KEY | For onchain tx on Solana |
onchain price btconchain balance 0x1234...5678onchain portfolio main # Uses saved wallet named "main"onchain polymarket trending -n 5 # Top 5 (respects config filters)
onchain polymarket trending --all # All markets, ignore config
onchain polymarket trending --exclude sports # Filter out sports on-the-flyonchain tx 0xd757e7e4cdb424e22319cbf63bbcfcd4b26c93ebef31d1458ab7d5e986375f31
onchain tx https://basescan.org/tx/0x... # Or paste explorer URLonchain search pepe # Find tokens matching "pepe"
onchain search "shiba inu" -l 5 # Limit to 5 resultsonchain gas # Ethereum gas prices
onchain gas --chain polygon # Polygon gas prices
onchain gas --json # JSON outputonchain --json price eth | jq '.priceUsd'Ethereum, BNB Chain, Polygon, Arbitrum, Optimism, Avalanche, Base, zkSync Era, Linea, Scroll, Blast, Mantle, Gnosis, Fantom, Celo, and more.
Full Solana mainnet support including SPL tokens and NFTs.
This CLI is designed for agent use. Key patterns:
--json for programmatic accessonchain setup, reference by name# 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')
# Get transaction details as JSON
TX=$(onchain --json tx 0x... --chain base)
echo $TX | jq '{status: .status, from: .from, to: .to, method: .methodId}'IMPORTANT: Trust the CLI output. The onchain tx command queries Etherscan (EVM) or Solscan (Solana) APIs directly and returns all available data.
DO NOT:
cast or other CLI tools as "fallbacks"DO:
onchain tx or onchain tx --json for structured data parsingExample interpretation:
onchain tx 0x... --chain baseIf output shows Status: SUCCESS, From: 0x..., To: 0x..., Method ID: 0x6a761202 - that's a successful contract interaction. The method ID 0x6a761202 is execTransaction (Gnosis Safe). No additional lookups needed.
Generated Mar 1, 2026
Retail investors can track their holdings across multiple wallets and exchanges in one place, using the CLI to monitor balances, portfolio values, and transaction history. This helps them make informed decisions without switching between platforms, especially for those with assets on both EVM and Solana chains.
Traders can use the CLI to fetch real-time prices, gas fees, and trending markets to time their trades effectively. The ability to search tokens and analyze prediction market sentiment provides insights into market trends, aiding in strategy development for short-term trading.
DeFi projects can leverage the transaction lookup feature to audit on-chain activities, verify contract interactions, and monitor gas usage across EVM chains. This supports compliance and security checks by providing detailed transaction data from explorers like Etherscan.
Analysts can explore Polymarket data to gauge public sentiment on topics like crypto, politics, or AI, using sentiment analysis and tag filtering. This aids in generating reports or forecasts based on crowd-sourced predictions, with JSON output for easy integration into analytical tools.
Businesses with Coinbase or Binance accounts can automate balance and trade history checks to reconcile records for accounting or tax purposes. The CLI simplifies data extraction from multiple CEX platforms, reducing manual effort in financial reporting.
Offer a free tier with basic market data and limited API calls, then charge for premium features like higher rate limits, advanced analytics, or priority support. Revenue can come from subscription plans tailored to individual users, traders, or enterprises needing extensive data access.
License the CLI technology to exchanges, wallets, or financial apps, allowing them to integrate portfolio tracking and market data into their own interfaces. This generates revenue through licensing fees or revenue-sharing agreements based on user adoption within partner platforms.
Aggregate and anonymize usage data from CLI commands to sell insights on market trends or user behavior to hedge funds or research firms. Additionally, resell access to enhanced APIs (e.g., for prediction markets) with custom endpoints for high-frequency users.
š¬ Integration Tip
Guide users to run 'onchain setup' first for API key configuration, and use the '--json' flag for agent-friendly output to streamline data parsing in automated workflows.
Analyze stocks and cryptocurrencies using Yahoo Finance data. Supports portfolio management, watchlists with alerts, dividend analysis, 8-dimension stock scoring, viral trend detection (Hot Scanner), and rumor/early signal detection. Use for stock analysis, portfolio tracking, earnings reactions, crypto monitoring, trending stocks, or finding rumors before they hit mainstream.
Get stock prices, quotes, fundamentals, earnings, options, dividends, and analyst ratings using Yahoo Finance. Uses yfinance library - no API key required.
Yahoo Finance (yfinance) powered stock analysis skill: quotes, fundamentals, ASCII trends, high-resolution charts (RSI/MACD/BB/VWAP/ATR), plus optional web a...
Become an autonomous prediction market trader on Polymarket with AI-powered analysis and a performance-backed token on Base. Trade real markets, build a track record, and let the buyback flywheel run.
Get cryptocurrency token price and generate candlestick charts via CoinGecko API or Hyperliquid API. Use when user asks for token price, crypto price, price chart, or cryptocurrency market data.
Trade and monitor Hyperliquid perpetual futures. Check balances, view positions with P&L, place/cancel orders, execute market trades. Use when the user asks about Hyperliquid trading, portfolio status, crypto positions, or wants to execute trades on Hyperliquid.