Onchain 命令行界面

用于加密货币投资组合追踪、市场数据和中心化交易所历史的命令行界面。

首次设置（必需）

在使用大多数功能之前，用户必须配置其 API 密钥：

onchain setup

此交互式向导有助于配置：

• Coinbase/Binance- 用于中心化交易所余额和交易历史
• DeBank- 用于 EVM 钱包数据（以太坊、Polygon、Arbitrum 等）
• Helius- 用于 Solana 钱包数据

未经设置：仅链上价格和链上市场功能可用（使用免费的 CoinGecko 服务层级）。

验证设置：运行onchain test以检查哪些服务提供商已配置且工作正常。

代理备注如果命令因"未配置"或"需要API密钥"而失败，请引导用户先运行onchain setup，然后运行onchain test以进行验证。

调用

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 chains

钱包数据

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

交易查询

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

支持EVM链（以太坊、Polygon、Base、Arbitrum、Optimism、BSC、Avalanche、Fantom）和Solana。接受原始哈希值或区块浏览器URL（如etherscan.io、basescan.org、solscan.io等）。

示例输出

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...

此输出包含所有可用的交易数据。CLI直接查询Etherscan/Solscan API——没有来自其他来源的额外数据。

中心化交易所数据

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

预测市场

onchain 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 topic

情感分析：分析预测市场以确定看涨/看跌预期：

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 agents

标签过滤：在~/.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- 输出为JSON（代理友好格式）
• --plain- 禁用颜色和表情符号
• --timeout <毫秒>- 请求超时时间

配置

配置文件：~/.config/onchain/config.json5

必需的API密钥

可选API密钥

示例

获取比特币价格

onchain price btc

检查钱包余额

onchain balance 0x1234...5678

查看包含DeFi持仓的投资组合

onchain 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-fly

查询交易

onchain tx 0xd757e7e4cdb424e22319cbf63bbcfcd4b26c93ebef31d1458ab7d5e986375f31
onchain tx https://basescan.org/tx/0x...  # Or paste explorer URL

搜索代币

onchain search pepe               # Find tokens matching "pepe"
onchain search "shiba inu" -l 5   # Limit to 5 results

检查Gas费用

onchain gas                   # Ethereum gas prices
onchain gas --chain polygon   # Polygon gas prices
onchain gas --json            # JSON output

脚本的JSON输出

onchain --json price eth | jq '.priceUsd'

支持的链

EVM (通过DeBank)

以太坊、BNB链、Polygon、Arbitrum、Optimism、Avalanche、Base、zkSync Era、Linea、Scroll、Blast、Mantle、Gnosis、Fantom、Celo等。

Solana (通过Helius)

完整的Solana主网支持，包括SPL代币和NFT。

代理集成

此CLI专为代理使用而设计。关键模式：

1. 始终使用--json用于程序化访问
2. 检查退出代码- 0表示成功，1表示错误
3. 使用已保存的钱包- 通过链上设置一次性配置
4. ，按名称引用速率限制

- API 有速率限制，请在快速调用之间添加延迟

# 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}'

代理使用示例

交易查询指南重要：请信任 CLI 输出。该链上交易

命令直接查询 Etherscan (EVM) 或 Solscan (Solana) API 并返回所有可用数据。

• 请勿：
• 使用 curl 直接调用 Etherscan/Basescan API使用cast
• 或其他 CLI 工具作为“备用方案”
• 使用 WebFetch 抓取区块浏览器网站

假设 CLI 缺少数据——它返回所有可用数据

• 请：使用或者链上交易 <explorer-url>
• 使用--json进行结构化数据解析
• 直接解释输出来回答用户问题

示例解释：

onchain tx 0x... --chain base

如果输出显示状态：成功，发送方：0x...，接收方：0x...，方法ID：0x6a761202——那是一次成功的合约交互。方法ID0x6a761202对应的是execTransaction（Gnosis Safe）。无需额外查询。