Assets represent the financial instruments or currencies that Accounts hold. Every Account is linked to exactly one Asset.

Assets can include:

• Currencies (e.g., BRL, USD, EUR)
• Cryptocurrencies (e.g., BTC, ETH)
• Non-currency assets (e.g., gold, loyalty points, tokenized securities)

Each Asset is managed independently within the Ledger, ensuring that balances remain clearly defined.

Multi-Asset

Modern finance isn’t limited to a single currency or asset class. Midaz supports traditional currencies, cryptocurrencies, commodities, and tokenized assets, all within a single system. Whether you’re managing multi-currency wallets, cross-border payments, or digital asset portfolios, Midaz makes transactions smooth and efficient.

Asset structure

• Asset > Account: Every Account is tied to a single Asset.
• Asset > Ledger > Account: Assets are defined at the Ledger level, and Accounts are created based on available Assets.

Key characteristics

• Assets must be explicitly defined before use.
• Each Asset has a unique identifier, such as a currency code.
• Multi-asset operations are handled through structured conversions.

📘

Note

When you create an Asset, Midaz automatically sets up an External Account if one doesn’t already exist. This ensures seamless backing for all transactions flowing in and out of the Ledger.

The External Account follows the naming convention @external/<asset-code>, for example, @external/BRL.

Managing Assets

---

You can manage your Assets either via API or through the Console.

Via API

• List Assets — View all Assets in your workspace.
• Retrieve an Asset — Get details of a specific Asset.
• Create an Asset — Register a new Asset in the Ledger.
• Update an Asset — Edit the properties of an existing Asset.
• Delete an Asset — Mark an Asset as deleted so it can no longer be used.

❗️

Important

An Asset can only be deleted if no balance remains in its Ledger accounts. You must transfer any remaining funds to an External Account before attempting to delete the Asset.

Via Console

All Asset management actions, including viewing, creating, editing, and deleting, can be done through the Assets page in the Midaz Console.

Learn more in theManaging Assets guide.