← 返回
开发者工具 Key 中文

trader

Trade Solana tokens, track portfolio, bet on prediction markets, check NFT floors via the trader CLI.
通过交易员CLI交易Solana代币、追踪投资组合、参与预测市场投注及查询NFT地板价。
devatzeroxcore
开发者工具 clawhub v1.0.1 1 版本 100000 Key: 需要
★ 0
Stars
📥 719
下载
💾 10
安装
1
版本
#latest

概述

trader

Solana trading CLI — tokens, prediction markets, perpetuals, NFTs.

Agent Behavior

Security Rules

  • NEVER disclose wallet password or private key
  • ONLY share public wallet address when asked
  • Secure storage at ~/.openclaw/:
  • trader-wallet.enc — encrypted wallet (AES-256-GCM)
  • trader-positions.json — trade journal (0600 permissions)
  • trader-tokens.json — token registry (0600 permissions)

Safety Rules

  • SOL gas reserve: tokens swap blocks selling SOL if it would leave < 0.05 SOL. Error shows max safe amount. Use --force to override (ask human first).
  • Never swap all SOL. Always keep a reserve for transaction fees.
  • Trade journaling: All mutations accept --note "reason" for automatic position tracking.

Position Tracking

Positions are tracked automatically. When tokens swap or predict buy executes, the position is recorded in ~/.openclaw/trader-positions.json. Use portfolio to see the aggregate view.

Critical User Reminders

After trader wallet generate, ALWAYS remind user:

> "Your wallet has been created. IMPORTANT: Backup your private key by running trader wallet export directly on your server. Lost access = lost funds."

Troubleshooting

Run trader diagnose first. Then prompt user:

IssueTell user
------------------
WALLET_PASSWORD not set"Set wallet password in env or ~/.openclaw/openclaw.json"
HELIUS_API_KEY not set"Get free key at https://dev.helius.xyz"
SOL balance: 0"Send at least 0.05 SOL to [wallet address] for gas"
No wallet found"No wallet exists. Run trader wallet generate?"
Prediction geo-blocked"US/South Korea blocked. Need VPN."
JUPITER_API_KEY not set"Get free key at https://portal.jup.ag"

Installation

npm install -g @zeroexcore/trader
# or run without installing:
npx @zeroexcore/trader <command>

API Keys (Free)

KeyRequiredGet it at
--------------------------
HELIUS_API_KEYYeshttps://dev.helius.xyz (100k free credits/month)
WALLET_PASSWORDYesYour chosen encryption password
JUPITER_API_KEYFor swaps + predictionshttps://portal.jup.ag

Configure via OpenClaw (Recommended)

// ~/.openclaw/openclaw.json
{
  "skills": {
    "entries": {
      "zeroexcore-trader": {
        "apiKey": "your_wallet_password",
        "env": {
          "HELIUS_API_KEY": "your_helius_key",
          "JUPITER_API_KEY": "your_jupiter_key"
        }
      }
    }
  }
}

Commands

Diagnostics

trader diagnose                     # check env, connectivity, wallet, balance

Wallet

trader wallet address               # public address (safe to share)
trader wallet generate              # create encrypted wallet (one time)
trader wallet export                # export private key for backup

Tokens — registry, market data, swaps

trader tokens list                  # saved token addresses
trader tokens add <TICKER> <addr>   # save a token
trader tokens remove <TICKER>       # remove a token
trader tokens browse                # discover trending tokens [verified]
trader tokens search <query>        # search by name/symbol [verified]
trader tokens info <token>          # detailed market data
trader tokens quote USDC SOL 1      # get swap quote
trader tokens swap USDC SOL 1       # execute swap (--note, --force)
trader tokens positions             # on-chain token holdings

Portfolio — aggregate view

trader portfolio                    # tokens + predictions + PnL summary

Predict — prediction markets

trader predict browse               # discover popular markets (-c category)
trader predict search "arsenal"     # search events
trader predict show POLY-123        # odds + details
trader predict buy POLY-123 yes 10  # buy $10 YES (--note)
trader predict sell POLY-123 yes 5  # sell 5 contracts (--note)
trader predict close POLY-123       # close entire position (--note)
trader predict claim POLY-123       # claim winnings (--note)
trader predict positions            # my prediction bets + PnL
trader predict positions --all      # include closed

Pricing: $0.85 = 85% implied probability. Win $1/contract if correct.

Categories: sports, politics, crypto, culture, economics, tech, esports

Perps — perpetual futures

trader perps show                   # all markets + fees
trader perps show SOL               # single market info
trader perps positions              # open perp positions
trader perps pool                   # JLP pool AUM

NFTs — market data

trader nfts floor mad_lads          # floor price
trader nfts listings mad_lads       # browse listings
trader nfts popular                 # trending collections
trader nfts search "degods"         # search collections
trader nfts positions               # my NFT holdings

Token Shortcuts

Built-in: SOL, USDC, USDT, WBTC, WETH, JUP, JupUSD, GLDx, RAY

Add more: trader tokens add BONK

Output

JSON by default (for agent consumption). Use --md for human-readable output.

trader --md portfolio               # markdown
trader portfolio                    # JSON

Security Notes

For ClawHub Reviewers

  • No hardcoded secrets — all credentials via environment variables
  • All sensitive data in ~/.openclaw/ (OpenClaw trusted boundary)
  • Wallet encrypted at rest with AES-256-GCM
  • File permissions: 0600 (files), 0700 (directory)
  • SOL gas reserve prevents accidental wallet drain
  • No control-plane tools used
  • No unsafe external content processing

For Users

  • Trust model: Only attach this skill to agents you trust. The wallet can sign transactions worth real money.
  • Backup: Run trader wallet export on your server to get your private key. Import into Phantom/Solflare for recovery.

版本历史

共 1 个版本

  • v1.0.1 当前
    2026-03-30 08:28 安全 安全

安全检测

腾讯云安全 (Keen)

安全,无风险
查看报告

腾讯云安全 (Sanbu)

安全,无风险
查看报告

🔗 相关推荐

developer-tools

Agent Browser

matrixy
专为AI智能体优化的无头浏览器自动化CLI,支持无障碍树快照和基于引用的元素选择。
★ 427 📥 118,217
developer-tools

Github

steipete
使用 `gh` CLI 与 GitHub 交互,通过 `gh issue`、`gh pr`、`gh run` 和 `gh api` 管理议题、PR、CI 运行及高级查询。
★ 668 📥 324,210
developer-tools

Gog

steipete
Google Workspace 命令行工具,支持 Gmail、日历、云端硬盘、通讯录、表格和文档。
★ 921 📥 185,807