Skip to main content
POST
/
digital-custody
/
deposit-addresses
Generate Deposit Address
curl --request POST \
  --url https://access.utgl.io/v1/digital-custody/deposit-addresses \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "accountId": "6a3176fe-7715-4fe0-a548-034912d7f800",
  "assets": [
    "USDC",
    "USDT",
    "HT"
  ],
  "chain": "ETH",
  "idempotencyKey": "xeev1she5eegh9daiviethahchoo1muW",
  "xid": "<string>",
  "xmetadata": {
    "key1": "value1",
    "key2": [
      "value2.1",
      "value2.2"
    ]
  }
}
'
[
  {
    "id": "c936a1ff-1d3c-45e1-af1f-ed497685a305",
    "address": "0x000000000dfde7deaf24138722987c9b6991e2d4",
    "asset": "USDC",
    "chain": "ETH",
    "addressTag": "<string>",
    "created": "2023-11-07T05:31:56Z",
    "xid": "<string>",
    "xmetadata": {
      "key1": "value1",
      "key2": [
        "value2.1",
        "value2.2"
      ]
    }
  }
]

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json
​
accountId
string<uuid>
required

Account ID

Example:

"6a3176fe-7715-4fe0-a548-034912d7f800"

​
assets
string[]

Symbol of digital asset

Example:
["USDC", "USDT", "HT"]
​
chain
string

Network to generate address for. If not provided, the default network for the asset will be used

Example:

"ETH"

​
idempotencyKey
string<string>

Unique idempotency key for ensuring exactly-once execution of mutating requests.

Example:

"xeev1she5eegh9daiviethahchoo1muW"

​
xid
string

External identifier, unique across all resources created under this account.

​
xmetadata
object

External metadata

Example:
{
  "key1": "value1",
  "key2": ["value2.1", "value2.2"]
}

Response

200 - application/json

OK

​
id
string
Example:

"c936a1ff-1d3c-45e1-af1f-ed497685a305"

​
address
string

An alphanumeric string representing a blockchain address. Will be in different formats for different chains. It is important to preserve the exact formatting and capitalization of the address.

Example:

"0x000000000dfde7deaf24138722987c9b6991e2d4"

​
asset
string
Example:

"USDC"

​
chain
string
Example:

"ETH"

​
addressTag
string

The secondary identifier for a blockchain address. An example of this is the memo field on the Stellar network, which can be text, id, or hash format.

​
created
string<date-time>
​
xid
string

External identifier, unique across all resources created under this account.

​
xmetadata
object

External metadata

Example:
{
  "key1": "value1",
  "key2": ["value2.1", "value2.2"]
}