FIfireblocks
Vaults

Bulk creation of new deposit addresses

For UTXO blockchains only.

Create multiple deposit addresses by running an async job.

  • The target Vault account should already have a UTXO asset wallet with a permanent address.
  • Limited to a maximum of 10,000 addresses per operation. Use multiple operations for the same Vault account/permanent address if needed.

Endpoint Permissions: Admin, Non-Signing Admin.

post/vault/accounts/addresses/bulk

Request

Headers

Idempotency-Keystring

A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours.

Request body

vaultAccountIdinteger required

Existing Vault account ID to add deposit addresses to

assetIdstring required

asset ID

countinteger required

Count of deposit addresses to issue

descriptionsstring[]

Desctiptions of the newly created addresses

vaultAccountToCopyDescFrominteger

Existing Vault Account ID to copy deposit addresses descriptions from in case no descriptions were provided

vaultAccountToCopyDescFromIndexinteger

Existing length within the vault account to copy deposit addresses descriptions from

Example request

{
  "vaultAccountId": 5,
  "assetId": "ADA",
  "count": 10,
  "descriptions": [
    "First address",
    "Second address",
    "df4c0987-30da-4976-8dcf-bc2dd41ae331"
  ],
  "vaultAccountToCopyDescFromIndex": 1000
}

Response

A JobCreated object

jobIdstring
approvalRequestIdstring

Approval request ID. Returned when a tag triggers an approval flow.

Changes

No recorded changes to this operation across all 1 revision of this API.