Create Deposit Address

Creates a deposit address for one account on a chosen network. dchain_id is required; an optional expired_at gives the address an expiry.

POST/api/accounts/{account_id}/deposit_addressesAuth: Required

expired_at does not stop money arriving

It is a shelf life for showing the address, not for the funds. The blockchain address stays valid forever, and a deposit that arrives after expired_at is credited normally.

What expiry actually does is stop the address being offered as active for new payments. So use it to rotate which address you display, not as a deadline you communicate to a customer — telling someone "pay before this time or lose the funds" would be wrong.

Request Body

dchain_idstringRequired

Dchain id

expired_atstring

Optional. The moment the address stops being offered for new payments, as an ISO 8601 timestamp. It does not limit the address itself — see above.

Response

201, with the address.

idnumberRequired

The address's own id. A deposit references it as deposit_address_id.

asset_idstringRequired

Asset code.

dchain_idstringRequired

Network code.

account_idnumber | nullRequired

The account this address belongs to. null on an address created together with an auto-conversion rule.

addressstringRequired

The blockchain address to be paid at.

tagstring | nullRequired

Destination memo, on networks that use one.

expired_atstring | nullRequired

When the address stops being offered for new payments. Funds arriving after it are still credited.

updated_atstringRequired

When the record last changed.

created_atstringRequired

When the record was created.

Errors

Beyond the shared errors:

Code	Meaning
1001	account_id is not yours, or dchain_id is missing or does not carry this account's asset
2020	This member has reached its deposit-address limit
3036	Address creation is temporarily switched off for the network the message names — retry later
3009	The core is in maintenance — retry later

POST/api/accounts/{account_id}/deposit_addresses

curl -X POST 'https://api.example.com/api/accounts/{account_id}/deposit_addresses' \
  -H 'Api-Token: YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '<body>'

BODY

{
  "dchain_id": "trc20usdt"
}

EXAMPLE RESPONSE

{
  "id": 39610,
  "asset_id": "usdt",
  "dchain_id": "trc20usdt",
  "account_id": 183133,
  "address": "TUtCfpKCY1FRuhFsuS2RiHQH8CsMma9DQ3",
  "tag": null,
  "expired_at": "2026-08-31T13:25:11.098Z",
  "updated_at": "2026-08-28T13:33:28.949Z",
  "created_at": "2026-08-28T13:33:28.935Z"
}