Circle APIs Documentation

Learn how to integrate with Circle APIs to accept traditional and USDC payments, automate payouts, embed multi-asset accounts into your product or service, or power your internet marketplace.

Your Master Wallet

What is the Master Wallet

Your Circle account has a master wallet that is automatically generated for you once you sign up.

This master wallet is the destination for the settlement of payments and the origin for payouts, in case you use our Payments API or Payouts API.

Obtaining Your Master Wallet Id

You can find your master wallet identifier by inspecting the value of property masterWalletId in the response obtained from the configuration endpoint. Do so by executing the following command.

# Replace ${YOUR_API_KEY} with your API key
curl -H 'Accept: application/json' \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -X GET --url

The response from the API call above will look like the below.


Your masterWalletId value will not change, so it is safe to store it, though you can always retrieve it via the configuration endpoint.

Updated 11 months ago

Your Master Wallet

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.