Assets

In Midaz, an Asset represents the item being transferred in a transaction.

As a multi-asset and multi-currency system, Midaz offers unparalleled flexibility, allowing you to define assets that suit your operational needs—whether they are digital, physical, or even unconventional forms of value.

Assets in Midaz empower organizations to transact with clarity, precision, and adaptability.


What is an Asset?


An Asset in Midaz can be anything of value that is used in transactions, such as:

  • Currencies: Traditional fiat currencies like BRL (Brazilian Real) or EUR (Euro), and cryptocurrencies like BTC (Bitcoin).
  • Physical Commodities: Items like soybeans, cattle, or even refrigerators.
  • Custom Items: Non-traditional forms of value, such as loyalty points, medicines, or any other tokenized item.

This flexibility ensures that Midaz can accommodate diverse business models, industries, and use cases.


Benefits of Assets in Midaz

  • Versatility: Define and manage diverse asset types to align with your unique business needs.
  • Precision: Customize configurations such as decimal places to match the characteristics of each asset.
  • Scalability: Add new assets as your organization’s operations expand or evolve.
  • Control: Activate or deactivate assets as needed, ensuring compliance and operational efficiency.

Key Characteristics of Assets

  1. Identification: Each Asset is uniquely identified by a code, such as BRL or BTC, which must be specified in every transaction.
  2. Active Status: To be used in a transaction, an Asset must be active on the platform. Attempting to transact with an inactive Asset will result in an error.
  3. Individual Configuration: Assets are created individually within a Ledger, enabling unique configurations such as the number of decimal places.

Example

Imagine a Ledger needs to handle Bitcoin (BTC) and Brazilian Real (BRL):

  • BTC can be configured with up to 8 decimal places.
  • BRL can be configured with 2 decimal places, reflecting traditional currency standards.

Managing Assets


To manage your Assets you can use the Assets API or the Assets tab of the Ledgers page on Midaz Console.

View Assets Details

  • Via API:
    • To view the details of all Assets, use the List Assets endpoint.
    • To view the details of a specific Asset, use the Retrieve an Asset endpoint.
  • Via Console: Access the Assets tab to view the detais of an Asset. For more information, refer to the Managing Assets page.

Create an Asset


Edit an Asset


Delete an Asset

  • Via API: Use the Delete an Asset endpoint.
  • Via Console: Delete an Asset from the Assets tab of the Ledgers page. For more information, refer to the Deleting an Asset page.

❗️

Important

An Asset can only be deleted if no balance is available in its Ledger accounts. Therefore, all remaining amounts must be moved to an External Account before deleting the Asset.