Skip to main content
POST
/
v1
/
businessAccount
/
wallets
/
addresses
/
deposit
Create a deposit address
curl --request POST \
  --url https://api-sandbox.circle.com/v1/businessAccount/wallets/addresses/deposit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "idempotencyKey": "ba943ff1-ca16-49b2-ba55-1057e70ca5c7"
}
'
{
  "data": {
    "address": "0x8381470ED67C3802402dbbFa0058E8871F017A6F",
    "addressTag": "123456789",
    "currency": "USD",
    "chain": "ALGO",
    "id": "b8627ae8-732b-4d25-b947-1df8f4007a29",
    "walletId": "1000999922"
  }
}

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.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
walletId
string

The wallet ID to be credited when deposits are made to this address. If not provided, deposits default to the main wallet of the account.

You can get wallet IDs associated with your account using the Core API for Institutions.

Body

application/json
​
idempotencyKey
string<uuid>
required

Universally unique identifier (UUID v4) idempotency key. This key is utilized to ensure exactly-once execution of mutating requests.

Example:

"ba943ff1-ca16-49b2-ba55-1057e70ca5c7"

​
currency
enum<string> | null
required

A currency associated with a balance or address.

Available options:
USD,
EUR,
BTC,
ETH,
CIRBTC
​
chain
enum<string>
required

A blockchain that a given currency is available on.

Note: Arc (ARC) is only available in the sandbox environment (api-sandbox.circle.com).

Available options:
ALGO,
APTOS,
ARB,
ARC,
AVAX,
BASE,
BTC,
CELO,
CODEX,
ETH,
HBAR,
HYPEREVM,
INK,
LINEA,
NEAR,
NOBLE,
OP,
PLUME,
PAH,
POLY,
SEI,
SOL,
SONIC,
SUI,
UNI,
WORLDCHAIN,
XDC,
XLM,
XRP,
ZKS,
ZKSYNC

Response

Successfully generated a new deposit address.

​
data
object