Authentication

Authentication Flow

Authentication flow:

1. Initiate sign-in — run auth signin --json and display the returned pairingCode to the user. The pairingCode must be displayed verbatim.
2. Open the link for the user — open the returned urlForWeb in the browser directly (e.g., open "<urlForWeb>" on macOS). The urlForWeb must be used verbatim from the JSON response — never modify, truncate, or reconstruct it. Also display the urlForWeb as a clickable link so the user can open it manually if the browser fails to launch.
3. Confirm in Binance App — the user verifies the pairingCode matches and confirms sign-in in the Binance Wallet App.
4. Verify — run auth verify --qrCodeId <qrCodeId> --json. This blocks until the user confirms in the Binance App (or times out after 5 minutes).

auth signin

Start the sign-in flow. Open the returned urlForWeb in the browser so the user can scan the QR code with the Binance Wallet App.

Syntax

baw auth signin --json

Parameters

No command-specific parameters.

Example

baw auth signin --json

Response

{
  "success": true,
  "data": {
    "urlForWeb": "https://web3.binance.com/en/agent-login?expireAt=1772767626000&url=xxx",
    "qrCodeId": "a191884d-0e05-435b-a887-336bc242fafc",
    "expireAt": "1772767626000",
    "pairingCode": "654321"
  }
}

If already logged in:

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

auth verify

Poll the QR-code scan status and wait for wallet creation to finish. This command blocks until the user confirms in the Binance App and the wallet is ready, or times out after 5 minutes.

Syntax

baw auth verify --qrCodeId <qrCodeId> --json

Parameters

Example

baw auth verify --qrCodeId a191884d-0e05-435b-a887-336bc242fafc --json

Response

Success:

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

Timeout, rejection, or other failure:

{
  "success": false,
  "error": {
    "code": 10002004,
    "name": "AUTH_REJECTED",
    "message": "QR code does not exist or expired, please try a new code or restart the log in process."
  }
}

auth signout

Sign out of the wallet and clear the local session.

Syntax

baw auth signout --json

Parameters

No command-specific parameters.

Example

baw auth signout --json

Response

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