Create a deposit address

POST {{baseUrl}}/v1/businessAccount/wallets/addresses/deposit

Generates a new blockchain address for a wallet for a given currency/chain pair. Circle may reuse addresses on blockchains that support reuse. For example, if you're requesting two addresses for depositing USD and ETH, both on Ethereum, you may see the same Ethereum address returned. Depositing cryptocurrency to a generated address will credit the associated wallet with the value of the deposit. Note: Circle Mint Singapore customers must verify all transfer recipients using the UI in the Circle Console, as transfers from unverified addresses will be held in pending status.

Body Params

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

currency string (REQUIRED) A currency associated with a balance or address.

chain string (REQUIRED) A blockchain that a given currency is available on.

Request Body

{"idempotencyKey"=>"{{$guid}}", "currency"=>"USD", "chain"=>"BASE"}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: Created

{"data":{"id":"22829df5-d3cd-5788-96dc-ee739c365007","address":"0x2adfe37f3645529815f786f0f24b870d563ea4f0","currency":"USD","chain":"BASE"}}