What is the Master Wallet

Your Circle Mint 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 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.