Commands Reference

aw init --json

AW_MASTER_PASSWORD='***' aw unlock --json

{ "ok": true, "data": { "status": "unlocked", "expires_at": "2026-03-01T10:15:00Z" } }

aw lock --json

aw health --json

{
  "ok": true,
  "data": {
    "version": "0.5.0",
    "default_chain": "ethereum",
    "home_dir": "~/.agentswallets",
    "db": { "ok": true },
    "session": { "ok": true },
    "rpc": { "ok": true },
    "solana_rpc": { "ok": true },
    "okx_api": { "ok": true },
    "hyperliquid_api": { "ok": true },
    "security_guard": { "ok": true }
  }
}

aw health --chain solana --json

{
  "ok": true,
  "data": {
    "version": "0.5.0",
    "default_chain": "ethereum",
    "home_dir": "~/.agentswallets",
    "db": { "ok": true },
    "session": { "ok": true },
    "rpc": { "ok": true },
    "solana_rpc": { "ok": true },
    "okx_api": { "ok": true },
    "hyperliquid_api": { "ok": true },
    "security_guard": { "ok": true }
  }
}

aw wallet create --name <name> --json

{
  "ok": true,
  "data": {
    "name": "bot",
    "evm_address": "0x4f3A...6a1",
    "solana_address": "7xKX...9vNq",
    "key_type": "hd",
    "supported_chains": ["ethereum", "bnb", "base", "polygon", "arbitrum", "solana"],
    "hint": "Fund your wallet by sending tokens to the EVM or Solana address above."
  }
}

aw wallet list --json

{
  "ok": true,
  "data": {
    "wallets": [
      { "name": "bot", "address": "0x4f3A...6a1", "key_type": "hd", "solana_address": "7xKX...9vNq", "created_at": "..." }
    ]
  }
}

aw wallet info bot --json
aw wallet info --wallet bot --json

{
  "ok": true,
  "data": {
    "name": "bot",
    "address": "0x4f3A...6a1",
    "key_type": "hd",
    "solana_address": "7xKX...9vNq",
    "created_at": "2026-03-01T10:00:00Z"
  }
}

aw wallet balance bot --json

{
  "ok": true,
  "data": {
    "name": "bot",
    "address": "0x...",
    "chain": "Ethereum",
    "chain_id": 1,
    "balances": { "ETH": "0.05", "USDC": "100.50", "USDT": "0.00" },
    "balances_number": { "ETH": 0.05, "USDC": 100.5, "USDT": 0.0 }
  }
}

aw wallet balance --all --json

aw wallet deposit-address bot --json
aw wallet deposit-address bot --chain solana --json

AW_ALLOW_EXPORT=1 aw wallet export-key bot --danger-export --yes --json

{
  "ok": true,
  "data": {
    "mnemonic": "abandon abandon abandon ... about",
    "warning": "Store this mnemonic securely. Anyone with access can derive all keys."
  }
}

aw wallet drain bot --to 0x9f4E...3bC1 --json
aw wallet drain bot --to 0x9f4E...3bC1 --chain polygon --json

{
  "ok": true,
  "data": {
    "drained": [
      { "token": "USDC", "amount": "100.50", "tx_hash": "0x..." },
      { "token": "ETH", "amount": "0.05", "tx_hash": "0x..." }
    ]
  }
}

aw send \
  --wallet bot \
  --to 0x9f4E...3bC1 \
  --amount 10 \
  --token USDC \
  --idempotency-key transfer-001 \
  --json

{ "ok": true, "data": { "tx_id": "tx_abc", "tx_hash": "0x...", "status": "confirmed" } }

aw tx list --wallet bot --limit 50 --json

aw tx status tx_abc123 --json

aw policy show bot --json

aw policy set bot \
  --limit-daily 1000 \
  --limit-per-tx 200 \
  --max-tx-per-day 50 \
  --allowed-tokens POL,USDC \
  --json

aw predict markets -q "bitcoin" --limit 5 --json

{ "ok": true, "data": { "markets": [{ "id": "...", "question": "...", "yes_price": 0.65, "no_price": 0.35 }] } }

aw predict buy \
  --wallet bot \
  --market mkt_abc \
  --outcome yes \
  --size 10 \
  --price 0.4 \
  --idempotency-key p1 \
  --json

aw predict sell \
  --wallet bot \
  --position pos_xyz \
  --size 5 \
  --idempotency-key p2 \
  --json

aw predict positions --wallet bot --json

{ "ok": true, "data": { "positions": [{ "id": "...", "market": "...", "outcome": "yes", "size": "10" }] } }

aw predict orders --wallet bot --json

{ "ok": true, "data": { "orders": [{ "id": "...", "market": "...", "side": "buy", "size": "10", "price": "0.4" }] } }

aw predict cancel --wallet bot --order-id ord_abc123 --json

aw predict approve-check --wallet bot --json

aw predict approve-set --wallet bot --json

aw predict update-balance --wallet bot --json

aw predict ctf-split --wallet bot --condition 0xabc123... --amount 10 --json

aw predict ctf-merge --wallet bot --condition 0xabc123... --amount 10 --json

aw predict ctf-redeem --wallet bot --condition 0xabc123... --json

aw predict bridge-deposit --wallet bot --json

aw keychain status --json

{ "ok": true, "data": { "available": true, "stored": false } }

aw keychain save --json

aw keychain remove --json

aw audit list --wallet bot --action tx.send --limit 10 --json

aw security status --json

{
  "ok": true,
  "data": {
    "security_guard": "active",
    "red_line_rules": 7,
    "yellow_line_rules": 7,
    "blacklisted_addresses": 0,
    "baseline_verified": true
  }
}

aw security blacklist add --address 0xBAD...123 --reason "Known scam" --json

aw security blacklist remove --address 0xBAD...123 --json

aw security blacklist list --json

aw security baseline init --json

{
  "ok": true,
  "data": {
    "baseline_hash": "sha256:abc123...",
    "files_tracked": 5,
    "created_at": "2026-03-15T10:00:00Z"
  }
}

aw security baseline verify --json

{
  "ok": true,
  "data": {
    "verified": true,
    "baseline_hash": "sha256:abc123...",
    "current_hash": "sha256:abc123..."
  }
}

aw security report --json

{
  "ok": true,
  "data": {
    "security_score": 95,
    "red_line_violations": 0,
    "yellow_line_warnings": 2,
    "anomalies_detected": 0,
    "baseline_status": "verified",
    "recommendations": ["Consider adding more addresses to the blacklist"]
  }
}

aw security anomaly agent-01 --json

{
  "ok": true,
  "data": {
    "wallet": "agent-01",
    "anomalies": [],
    "patterns_analyzed": ["transaction_frequency", "amount_deviation", "time_of_day", "destination_diversity"],
    "status": "clean"
  }
}