Wallet View Commands

`wallet status`

Check the current authentication and wallet state.

Syntax

bash

baw wallet status --json

Parameters

No command-specific parameters.

Example

bash

baw wallet status --json

Response

json

{
  "success": true,
  "data": {
    "status": "CONNECTED"
  }
}

Status	Meaning
`UNCONNECTED`	Not signed in
`CREATING`	Signed in; wallet being set up
`CONNECTED`	Signed in; wallet ready to use

`wallet chains`

List the blockchain networks the wallet currently supports.

Syntax

bash

baw wallet chains --json

Parameters

No command-specific parameters.

Example

bash

baw wallet chains --json

Response

json

{
  "success": true,
  "data": [
    { "binanceChainId": "56", "name": "BNB Smart Chain", "simpleName": "BSC" }
  ]
}

`wallet address`

Retrieve the wallet addresses.

Syntax

bash

baw wallet address --json

Parameters

No command-specific parameters.

Example

bash

baw wallet address --json

Response

json

{
  "success": true,
  "data": {
    "addresses": [
      {
        "binanceChainId": "CT_501",
        "chainName": "Solana",
        "address": "E...S"
      },
      {
        "binanceChainId": "1",
        "chainName": "Ethereum",
        "address": "0x1234...5678"
      },
      {
        "binanceChainId": "56",
        "chainName": "BSC",
        "address": "0x1234...5678"
      },
      {
        "binanceChainId": "8453",
        "chainName": "Base",
        "address": "0x1234...5678"
      }
    ]
  }
}

`wallet balance`

Query token balances. Only tokens with a value of at least $0.01 USD are returned; tokens worth less than $0.01 are hidden by CLI.

Syntax

bash

baw wallet balance [--symbol <symbol>] [--tokenAddress <tokenAddress>] [--binanceChainId <binanceChainId>] --json

Parameters

Parameter	Required	Default	Description
`--symbol`	No	—	Filter by token symbol (e.g., `BNB`, `USDT`, `USDC`)
`--tokenAddress`	No	—	Filter by token contract address
`--binanceChainId`	No	—	Binance chain ID: `56` (BSC), `CT_501` (Solana). For a full list, see `wallet chains`

Example

bash

# Query all balances
baw wallet balance --json

# Query USDT balance only
baw wallet balance --symbol USDT --json

Response

json

{
  "success": true,
  "data": [
    { "symbol": "USDT", "address": "0x55d398326f99059fF775485246999027B3197955", "binanceChainId": "56", "balance": "1000.50", "price": "1.0", "value": "1000.50" }
  ]
}

`wallet tx-history`

Retrieve transaction history with optional filtering and pagination.

Syntax

bash

baw wallet tx-history [--type <type>] [--size <size>] [--nextCursor <nextCursor>] [--tx <tx>] [--startTime <startTime>] [--endTime <endTime>] [--binanceChainId <binanceChainId>] --json

Parameters

Parameter	Required	Default	Description
`--type`	No	`all`	`all`, `pending`, `confirmed`
`--size`	No	`20`	Results per page (max 100)
`--nextCursor`	No	—	Pagination cursor from a previous response
`--tx`	No	—	Look up a single transaction by hash
`--startTime`	No	3 months ago	Start time (ms timestamp)
`--endTime`	No	—	End time (ms timestamp)
`--binanceChainId`	No	—	Binance chain ID: `56` (BSC), `CT_501` (Solana). For a full list, see `wallet chains`

Example

bash

# Query recent transactions
baw wallet tx-history --json

# Query pending transactions
baw wallet tx-history --type pending --json

# Look up a specific transaction
baw wallet tx-history --tx 0xabc123... --json

Response

json

{
  "success": true,
  "data": {
    "transactions": [
      {
        "txType": "swap",
        "txHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
        "txTime": "2026-04-01T09:05:30+08:00",
        "binanceChainId": "56",
        "status": "confirmed",
        "txHashList": [
          {
            "binanceChainId": "56",
            "txHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
            "status": "confirmed",
            "networkFee": {
              "binanceChainId": "56",
              "feeTokenAddress": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
              "feeTokenSymbol": "BNB",
              "feeValue": "0",
              "feeTokenDecimals": 18
            },
            "instructions": {
              "send": [
                {
                  "binanceChainId": "56",
                  "amount": "1000000000000000000",
                  "addressInfo": { "address": "0x1234...5678" },
                  "tokenInfo": {
                    "binanceChainId": "56",
                    "contractAddress": "0xcaca...1231",
                    "symbol": "Token1",
                    "tokenId": null,
                    "decimals": 18
                  }
                }
              ],
              "receive": [
                {
                  "binanceChainId": "56",
                  "amount": "1000000000000000000",
                  "addressInfo": { "address": "0x1234...5678" },
                  "tokenInfo": {
                    "binanceChainId": "56",
                    "contractAddress": "0xcaca...1232",
                    "symbol": "Token2",
                    "tokenId": null,
                    "decimals": 18
                  }
                }
              ]
            }
          }
        ]
      }
    ],
    "hasMore": true,
    "nextCursor": "__CONFIRMED__:1234567890"
  }
}

`wallet tx-lock`

Check whether the wallet is currently locked from sending new transactions.

Syntax

bash

baw wallet tx-lock --binanceChainId <binanceChainId> --json

Parameters

Parameter	Required	Default	Description
`--binanceChainId`	Yes	—	Binance chain ID: `56` (BSC), `CT_501` (Solana). For a full list, see `wallet chains`

Example

bash

baw wallet tx-lock --binanceChainId 56 --json

Response

json

{
  "success": true,
  "data": {
    "status": "UNLOCKED"
  }
}

Status	Meaning
`UNLOCKED`	The wallet is free to send new transactions.
`LOCKED`	A transaction is pending on-chain, or a double-confirm request is waiting in the Binance App. The user must resolve it before starting a new transaction.

The wallet becomes locked in two situations:

Transaction pending on-chain — a previously submitted transaction has not yet been confirmed on the blockchain. Nothing to do but wait; re-check with wallet tx-lock after a short while.
Double-confirm pending — the transaction triggered a risk-control check (either the token is flagged as risky, or a DEX swap has excessive price deviation). Tell the user to open the Binance App to approve or reject it (5-minute timeout).