Vaults
Create a Vault
Create a new vault in your organization. The vault needs your API user’s approval before it takes effect.
Request example
Response example
POST
After approval, retrieve the vault until
/api/external/vaults/
Request body
Vault name. Cannot be blank. Naming it “NGN” does not set its asset; asset is not a create input.
Requested wallet chains. Use identifiers from Assets and Chains.
Response
Returns the new Vault. Wallet addresses can be generated after the response, so retrieve the vault untilwalletsGenerated is true before using them.
Sub-org that owns the vault, if any.
DEFAULT, EXCHANGE, or GAS. See VaultType.Currency of a multi-currency account vault, for example
NGN. null for self-custody vaults.Approve the vault
Creating a vault opens a change request that your API user must approve. Call Get Approval Message withentityId set to the vault id, sign the message, and send the signature to Submit Approval Action. See Approvals for the full flow.
With the SDK, approve separately or in one call:
walletsGenerated === true before using its wallet addresses. Approval does not make wallet generation synchronous.
Request example
Response example