How-to: Create deposit addresses

Generate blockchain-specific deposit addresses so your end customers can receive stablecoins from external wallets. After creating an address, you can list existing addresses for an account and monitor incoming deposits as they credit the account balance.

Prerequisites

Before you begin:

Obtain an API key for Digital Asset Accounts from Circle.
Have an onboarded and active account with an accountId.
Install cURL on your development machine.

The Digital Asset Accounts API base URL is https://api-sandbox.circle.com for sandbox and https://api.circle.com for production. Set your API key in the Authorization header using the format Bearer YOUR_API_KEY. See Sandbox environment and Going to production for environment details.

Steps

Step 1. Generate a deposit address

Create a deposit address for a specific blockchain. You can create multiple addresses per account, one for each blockchain. For valid chain values, see Supported currencies and blockchains.

curl --request POST \
  --url https://api-sandbox.circle.com/v1/accounts/addresses/deposit \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer ${YOUR_API_KEY}' \
  --header 'Content-Type: application/json' \
  --data '
{
  "idempotencyKey": "${RANDOM_UUID}",
  "currency": "USD",
  "chain": "ETH",
  "accountId": "${ACCOUNT_ID}"
}
'

Response

{
  "data": {
    "id": "d1e2f3a4-b5c6-7890-def1-234567890abc",
    "address": "0xabcdef1234567890abcdef1234567890abcdef12",
    "currency": "USD",
    "chain": "ETH",
    "accountId": "1017381855"
  }
}

Share the address value with your end customer. Any USDC sent to this Ethereum address is credited to the account. If you pass an unsupported value in the chain field, the API returns a 400 error:

{
  "code": 400,
  "message": "Unsupported chain value. See supported currencies and blockchains for valid options."
}

See the supported currencies and blockchains reference for valid values.

Step 2. List deposit addresses

Retrieve all deposit addresses for an account.

curl --request GET \
  --url 'https://api-sandbox.circle.com/v1/accounts/addresses/deposit?accountId=${ACCOUNT_ID}' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer ${YOUR_API_KEY}'

Response

{
  "data": [
    {
      "id": "d1e2f3a4-b5c6-7890-def1-234567890abc",
      "address": "0xabcdef1234567890abcdef1234567890abcdef12",
      "currency": "USD",
      "chain": "ETH",
      "accountId": "1017381855"
    }
  ]
}

Step 3. Monitor incoming deposits

Track stablecoins as they arrive at a deposit address. A stablecoin sent to a deposit address is recorded as a transfer with a blockchain source, so you monitor it with the Transfers endpoints. The Deposits endpoint returns bank deposits only. List the transfers that arrived from a blockchain by calling List account transfers with sourceType=blockchain. Pass the clientEntityId of the end customer that owns the account. You receive it when you create a partner client. Without it, the list is empty. Results are sorted newest first, up to 50 per page.

curl --request GET \
  --url 'https://api-sandbox.circle.com/v1/accounts/transfers?accountId=${ACCOUNT_ID}&clientEntityId=${CLIENT_ENTITY_ID}&sourceType=blockchain' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer ${YOUR_API_KEY}'

Response

{
  "data": [
    {
      "id": "f3a4b5c6-d7e8-9012-f345-6789abcdef01",
      "source": {
        "type": "blockchain",
        "chain": "ETH"
      },
      "destination": {
        "type": "account",
        "id": "1017381855",
        "address": "0xabcdef1234567890abcdef1234567890abcdef12"
      },
      "amount": {
        "amount": "1000.00",
        "currency": "USD"
      },
      "transactionHash": "0x4cebf8f90c9243a23c77e4ae20df691469e4b933b295a73376292843968f7a63",
      "status": "complete",
      "createDate": "2026-03-16T08:30:00Z"
    }
  ]
}

Use the following fields to identify each deposit:

destination.address: the deposit address that received the funds
source.chain: the blockchain the funds arrived on
transactionHash: the hash of the onchain transaction
status: pending, complete, or failed

Step 4. Get a deposit

Retrieve a single deposit by its transfer ID, for example to check whether a pending deposit is now complete. Use the id value from the list response in Step 3. For the full response schema, see Get an account transfer.

curl --request GET \
  --url https://api-sandbox.circle.com/v1/accounts/transfers/${TRANSFER_ID} \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer ${YOUR_API_KEY}'

Response

{
  "data": {
    "id": "f3a4b5c6-d7e8-9012-f345-6789abcdef01",
    "source": {
      "type": "blockchain",
      "chain": "ETH"
    },
    "destination": {
      "type": "account",
      "id": "1017381855",
      "address": "0xabcdef1234567890abcdef1234567890abcdef12"
    },
    "amount": {
      "amount": "1000.00",
      "currency": "USD"
    },
    "transactionHash": "0x4cebf8f90c9243a23c77e4ae20df691469e4b933b295a73376292843968f7a63",
    "status": "complete",
    "createDate": "2026-03-16T08:30:00Z"
  }
}

Mint

Match

StableFX

Digital Asset Accounts

End User Onboarding

How-to: Create deposit addresses

Prerequisites

Steps

Step 1. Generate a deposit address

Step 2. List deposit addresses

Step 3. Monitor incoming deposits

Step 4. Get a deposit

See also

​Prerequisites

​Steps

​Step 1. Generate a deposit address

​Step 2. List deposit addresses

​Step 3. Monitor incoming deposits

​Step 4. Get a deposit

​See also

Prerequisites

Steps

Step 1. Generate a deposit address

Step 2. List deposit addresses

Step 3. Monitor incoming deposits

Step 4. Get a deposit

See also