Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.circle.com/llms.txt

Use this file to discover all available pages before exploring further.

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:
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.