balance コマンド

balance コマンドは、ウォレットの残高を全チェーン・主要トークン横断のサマリーで表示します。オプションは受け付けません（対象ウォレットは kova init で設定したアカウントが自動的に使われます）。

構文


kova balance

引数・オプションはありません。サポートされている全チェーンについて、ネイティブトークンと主要トークン（USDC / USDT / JPYC）＋ユーザー登録トークンの残高をまとめて取得します。

出力

対話端末（TTY）では人間向けの表、パイプ・リダイレクト・CI・AI エージェント経路（非 TTY）では JSON を返します（出力形式を参照）。

整形表示（TTY）


チェーン       トークン       残高
─────────────  ─────────────  ──────────────
base           native (ETH)   0.05 ETH
base           USDC           12.5 USDC
polygon        native (POL)   10.25 POL
polygon        JPYC           5000 JPYC
ethereum       native (ETH)   error

保有している残高（0 より大きいもの）だけが行として表示されます。 残高 0 / 未保有のチェーン・トークンは出力に含まれません。すべて 0 のときは「保有トークンなし」と表示されます
残高 error: そのチェーンの取得に失敗した行（JSON では balance: null / status: "error"）。他チェーンは独立に表示されます

JSON（非 TTY）


{
  "ok": true,
  "data": {
    "rows": [
      { "chain": "base", "tokenKey": "native", "symbol": "ETH", "balance": "0.05", "status": "ok" },
      { "chain": "base", "tokenKey": "USDC", "symbol": "USDC", "balance": "12.5", "status": "ok" },
      { "chain": "polygon", "tokenKey": "native", "symbol": "POL", "balance": "10.25", "status": "ok" },
      { "chain": "ethereum", "tokenKey": "native", "symbol": "ETH", "balance": null, "status": "error" }
    ]
  },
  "meta": {
    "mode": "owner",
    "authMethod": "passphrase",
    "policyApplied": false,
    "policyWouldBlock": null
  }
}

出力フィールド（`data.rows[]`）

フィールド	説明	例
`chain`	チェーン名	`"base"`, `"ethereum"`, `"polygon"`
`tokenKey`	トークンキー（ネイティブは `"native"`）	`"native"`, `"USDC"`
`symbol`	トークンシンボル	`"ETH"`, `"USDC"`, `"JPYC"`
`balance`	残高（人間が読める形式）。取得失敗時は `null`	`"12.5"`
`status`	セルの状態（`ok` または `error`）。残高 0 / 未保有の行は出力に含まれない	`"ok"`

特定のチェーン・トークンだけ見たいとき

kova balance は全チェーン横断サマリー専用で、チェーンやトークンを絞るオプションはありません。1 セルだけ抽出したい場合は JSON 出力を jq でフィルタします。


# Base の USDC 残高だけ取り出す
kova balance --json | jq '.data.rows[] | select(.chain == "base" and .symbol == "USDC")'

よくあるエラーと対処法

WALLET_NOT_FOUND

エラーメッセージ:


{
  "ok": false,
  "error": {
    "code": "WALLET_NOT_FOUND",
    "message": "No wallet configured. Run \"kova init\" first."
  }
}

対処法:

kova init でアカウントをセットアップする
既にアカウントがある場合は kova wallet info で確認する

一部のチェーンだけ取得に失敗する（`error` セル）

特定チェーンの RPC が一時的に応答しない場合、そのチェーンのセルだけが error（JSON では balance: null / status: "error"）になり、他チェーンは正常に表示されます。

対処法:

ネットワーク接続を確認する
カスタム RPC URL を使用している場合は URL が正しいか確認する（kova config list）
しばらく待ってから再実行する

チェーンとトークンの対応

サマリーには各チェーンのネイティブトークンと主要トークンが含まれます。

チェーン	ネイティブトークン	主要 ERC-20 トークン
Ethereum	ETH	USDC, USDT, JPYC
Base	ETH	USDC, USDbC
Polygon	POL	USDC, USDT, JPYC
Arbitrum	ETH	USDC, USDC.e, USDT
Optimism	ETH	USDC, USDC.e, USDT

詳細は、サポートチェーン一覧およびサポートトークン一覧を参照してください。kova token add で登録したユーザートークンもサマリーに表示されます。

AIエージェントでの使用例

Kova は、AI エージェントとの統合を前提に設計されています。以下は、スキルを使った自然言語での残高確認の例です。

ユーザー（自然言語）:

“残高を確認して”
“いくら持ってる？”
“USDC はいくらある？”

AIエージェントの実行:


# check-balance スキルが kova balance を実行し、全チェーンの残高を取得
kova balance

詳細は、AIエージェント統合ガイドを参照してください。

次のステップ

送金する: send コマンドで送金方法を学びましょう
送金ガイド: 送金・受取ガイドで詳細な手順を確認しましょう
チェーンとトークン: チェーンとトークンでサポートされているチェーンとトークンを確認しましょう
AIエージェント統合: AIエージェント統合ガイドでスキル経由の残高確認を学びましょう