Circle APIs Documentation

Learn how to integrate with Circle APIs to accept traditional and stablecoin payments, embed digital wallets 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 the Circle Payments 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 https://api-sandbox.circle.com/v1/configuration

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

{
  "data":{
    "payments":{
      "masterWalletId":"0000000001"
    }
  }
}

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

Updated 5 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.