Skip to main content

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

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 below.

In progress

The response fields for this endpoint are still being written up. Until then, the Swagger UI lets you run the call and see the actual response.

Errors

Beyond the shared errors:

CodeMeaning
1001account_id is not yours, or dchain_id is missing or does not carry this account's asset
2020This member has reached its deposit-address limit
3036Address creation is switched off for this network — the message names it
3009The core is in maintenance — retry later
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.