Accounts

An account holds a EURD balance. One profile can have multiple accounts — useful for separating funds per project or agent.

get_account_balance

Retrieve the EURD balance for an account.

get_account_balance(
  accountCode?: string,        // Identify by account code
  blockchainAddress?: string   // Or by Algorand address
)

Returns: { accountCode, balance, currency, blockchainAddress }

---

list_accounts

List all accounts linked to your profile.

list_accounts(
  accountCode?: string   // Optional filter
)

---

create_managed_account

Create a new managed EURD account. Quantoz holds the keys; you control it via the API.

create_managed_account(
  customName?: string,   // Min 3 chars
  metadata?: string      // Max 4000 chars
)

---

create_selfhosted_account

Whitelist an Algorand wallet address you control as a EURD account. You hold the private key.

create_selfhosted_account(
  blockchainAddress: string,
  transferNote: string,    // Required for whitelisting verification
  customName?: string,
  metadata?: string
)

---

update_account

Rename an account.

update_account(
  accountCode: string,
  customName: string   // Min 3 chars
)

---

delete_account

Delete a managed account or unlink a self-hosted account. The account balance must be zero before deletion.

delete_account(accountCode: string)

---

generate_whitelist_otp

Generate a one-time password valid for 2 minutes. Required when whitelisting a self-hosted account.

generate_whitelist_otp()

---

revoke_partner_consent

Remove a partner’s act-on-behalf consent for a specific account.

revoke_partner_consent(accountCode: string)

---

get_profile_account

Retrieve profile tier and account details for a user by email. Requires BusinessBasic scope.

get_profile_account(
  email: string,
  accountCode?: string
)