Skip to main content

wallet balance

Query native or ERC-20 token balances by address and chain. Uses eth_getBalance for native tokens and ERC-20 balanceOf for tokens. No API key required; uses on-chain RPC reads.
defi wallet balance --chain 1 --address 0xYourEOA --results-only
defi wallet balance --chain 8453 --address 0xYourEOA --asset USDC --results-only
Flags:
  • --chain string required — chain identifier
  • --address string required — account address
  • --asset string optional — token symbol/address/CAIP-19 (omit for native balance)
  • --rpc-url string optional — RPC URL override
Caveats:
  • EVM chains only; Solana is not yet supported.
  • Does not query pending/unconfirmed balances.

schema [command path]

Print machine-readable command schema.
defi schema --results-only
defi schema "swap quote" --results-only
defi schema "transfer plan" --results-only
Schema output includes:
  • inherited and local flags
  • typed defaults plus required, enum, format, and scope
  • command metadata such as mutation, input_modes, input_constraints, auth, and request/response structure hints when available
  • mutation commands advertise whether they accept flags, json, file, and stdin input modes
Common input_constraints examples:
  • exactly_one_of for mutually exclusive identity or amount inputs
  • required for provider-specific inputs that only apply on some routes
  • forbidden for inputs that must not be combined with a selected provider/runtime

version

Print CLI version.
defi version
defi version --long

completion

Generate shell completion scripts.
defi completion zsh
defi completion bash
defi completion fish
defi completion powershell

Cache bypass behavior

version, schema, and providers list bypass cache initialization.