How-to: Withdraw your balance

Withdraw remaining USDC from your Gateway balance back to your agent wallet.

Withdraw remaining USDC from your Gateway balance back to your agent wallet on the same blockchain. Useful when you’re done making nanopayments and want to recover unused funds.

Prerequisites

Before you begin, ensure you have:

• Installed Node.js v20.18.2 or later.

• Installed Circle CLI:

  npm install -g @circle-fin/cli
  

• Completed the Agent Wallets quickstart (authenticates and funds your wallet).

USDC is minted on the same blockchain as your Gateway balance. Crosschain withdrawals aren’t supported.

Steps

1. Withdraw from Gateway

   Run circle gateway withdraw with the amount, your wallet address, and the blockchain where your Gateway balance lives:

   circle gateway withdraw --amount 1 --address 0xYourWalletAddress --chain BASE
   

   To send the withdrawn USDC to a different address, add --recipient:

   circle gateway withdraw --amount 1 --address 0xYourWalletAddress --chain BASE --recipient 0xOtherAddress
   

   Not sure which blockchain your balance lives on? Run circle gateway balance --all to see all blockchains.

2. Confirm the withdrawal

   Check that your Gateway balance decreased:

   circle gateway balance --address 0xYourWalletAddress --chain BASE
   

   Then check that your wallet balance increased:

   circle wallet balance --address 0xYourWalletAddress --chain BASE
   

See the CLI command reference for full syntax and options.