Skip to main content
An Asset defines the unit of value that Accounts and Transactions use inside a Ledger. Create Assets before you create Accounts, because every Account uses one Asset.

​
Before you start

You need an existing Organization and Ledger. Decide whether the Asset is a currency, crypto asset, commodity, or another custom unit of value.
Choose Asset codes carefully. Accounts and Transactions depend on them.

​
Create the Asset

1
From the Assets page, click the New Asset button.
2
The New Asset form opens on the right side of the screen.
3
Select the Type of Asset.
  • Crypto: for cryptocurrencies such as Bitcoin, Ethereum, and Ripple.
  • Commodity: for tradable raw materials such as gold, natural gas, soybeans, and corn.
  • Currency: for currencies such as Brazilian Real, US Dollar, and Euro.
  • Others: for any other type of Asset.
You cannot reuse an Asset name or code in the same Ledger. Both the name and the code must be unique.
4
Specify the Asset Name.
5
Specify the Code for the Asset. Use uppercase letters only.
  • If the Asset is a currency, select its code from the ISO 4217 list.
6
[Optional] Select the Metadata tab to add custom metadata.
7
After you fill in the fields, click the Save button.
8
The Asset appears in the list of available Assets for your Ledger.
Saving an Asset also provisions a system-managed External Account when one does not already exist for that Asset code. Its canonical alias is @external/<asset-code>.
The fields in the Metadata tab are open. There are no predefined keys or values. Use consistent key names across your Organization, such as country, settlementNetwork, or regulatoryClass, so you can filter and audit Assets later.

​
Field guide

​
What to do next

After creating the Asset, create Accounts that use it in Creating an Account.

API equivalent

Create an Asset endpoint