Glossary

A reference of key terms and concepts used across the Metal API documentation.

TermDefinition
appcoinAppcoins are tokens that are inherently linked to one (or more) end-user application or service. It signifies a connection between app and token, but does not imply control or ownership of the app.
distributeThe process of transferring tokens from the Reward Allocation to a holder. There will only be tokens in the Reward Allocation if you toggled this option on during token creation.

Only the creator of the token can distribute tokens.
holderRefers to an end-user of the merchant for whom a wallet was created with Get Or Create Holder. In other words, these are your authenticated users. It's possible for a holder to have a token balance of zero.
holderAddressA unique address associated with your user to hold and manage token balances. Automatically created during when you call Get Or Create Holder.
liquidityHow easily a token can be bought or sold by open market participants without affecting its price.
liquidity creationThe process of deploying a liquidity pool, making the token discoverable and tradable for open market participants.
merchantThe entity that creates and manages tokens using Metal, in other words: you!
merchant allocationA portion of the total token supply that is transferred to an arbitrary address. Currently set to a fixed 5% of the total supply and cannot be editted.

Make sure this is an address you control on Base.
publicKeyA query parameter required in our GET endpoints to retrieve data client-side. You can find it in your Metal account.
reward allocationA portion of the total token supply that is kept separately for the purpose of rewarding users. Currently set to a fixed 10% of the total supply and cannot be editted.
secret API keyA private credential used to authenticate API requests. You can find it in your Metal account.

Never expose your secret API key in client-side code.
token creationInitiating the deployment of a token contract on the blockchain (Base). This token contract represents your appcoin.

Note: Unlike many other token platforms, this does not include the deployment of a liquidity pool. Metal gives you the flexibility to initiate liquidity deployment at a later stage.
token spendingAn action your app's users take to consume tokens from their holder balance. The tokens are transferred to your Reward Allocation (at which point you are free to distribute again).
userIdA unique identifier assigned by you to represent your users.

It can be any stable string tied to your user system—such as an OAuth subject, internal user ID, or email.
withdrawing tokensAn action your app's users take to transfer tokens to an externally owned address of theirs.

This must be an address they have access to on Base. Lost tokens cannot be recovered.

Was this page helpful?