Cubewire LogoDeveloper
Support
Onboarding
Cubewire Developer Hub Logo
SOC 2 Compliant

Developer documentation and tools for Cubewire's digital wallet infrastructure. Built for developers, by developers.

developers@cubewire.com
TwitterGitHubDiscord

Developer Tools

  • API Documentation
  • API Reference

Resources

  • Documentation

Company

  • About
  • Contact

Legal

  • Privacy Policy
  • Terms of Service
© 2026 Cubewire. All rights reserved.
Developer Documentation Portal•Built with ♥ for developers
  1. Cubewire Wallet
  2. Manage Vaults
  3. Get vault by blockchain address

Get vault by blockchain address

Retrieve vault details using the on-chain blockchain address instead of the vault UUID.

Path Parameters

ParameterTypeRequiredDescription
addressstringYesEthereum address in 0x... format

Response Fields

Returns complete vault data:

FieldTypeDescription
idUUIDUnique vault identifier
namestringHuman-readable vault name
typeenumVault type — HSM
statusenumVault status - active or inactive
keyStatusenumKey generation status - ready, pending, or failed
keyErrorstringError message if key generation failed (nullable)
userIdUUIDID of user who created the vault
organizationIdUUIDOrganization ID that owns the vault
addressstringEthereum-compatible blockchain address (0x...)
bsbstringBank State Branch code (for fiat integrations, nullable)
accountNumberstringBank account number (for fiat integrations, nullable)
groupNamestringOptional grouping label for organizing vaults (nullable)
tagsstring[]Array of string tags for filtering
createdAtdatetimeCreation timestamp (ISO 8601, UTC)
updatedAtdatetimeLast modification timestamp (ISO 8601, UTC)
assetsarrayArray of asset balances associated with this vault
userobjectNested user object containing user id

Use Cases

  • Look up vault details from blockchain explorer links
  • Retrieve vault information after monitoring on-chain transactions
  • Cross-reference on-chain activity with vault records
  • Build address-based vault detail views

Required Permission

vaults:read

On this page

  • Path Parameters
  • Response Fields
  • Use Cases
  • Required Permission
  1. Cubewire Wallet
  2. Manage Vaults
  3. Get vault by blockchain address

Get vault by blockchain address

Retrieve vault details using the on-chain blockchain address instead of the vault UUID.

Path Parameters

ParameterTypeRequiredDescription
addressstringYesEthereum address in 0x... format

Response Fields

Returns complete vault data:

FieldTypeDescription
idUUIDUnique vault identifier
namestringHuman-readable vault name
typeenumVault type — HSM
statusenumVault status - active or inactive
keyStatusenumKey generation status - ready, pending, or failed
keyErrorstringError message if key generation failed (nullable)
userIdUUIDID of user who created the vault
organizationIdUUIDOrganization ID that owns the vault
addressstringEthereum-compatible blockchain address (0x...)
bsbstringBank State Branch code (for fiat integrations, nullable)
accountNumberstringBank account number (for fiat integrations, nullable)
groupNamestringOptional grouping label for organizing vaults (nullable)
tagsstring[]Array of string tags for filtering
createdAtdatetimeCreation timestamp (ISO 8601, UTC)
updatedAtdatetimeLast modification timestamp (ISO 8601, UTC)
assetsarrayArray of asset balances associated with this vault
userobjectNested user object containing user id

Use Cases

  • Look up vault details from blockchain explorer links
  • Retrieve vault information after monitoring on-chain transactions
  • Cross-reference on-chain activity with vault records
  • Build address-based vault detail views

Required Permission

vaults:read

On this page

  • Path Parameters
  • Response Fields
  • Use Cases
  • Required Permission