Memos, Destination Tags & Messages

What is a memo, destination tag or message?

A memo or destination tag is an additional feature used by tag-based assets to further identify the recipient beyond the wallet address. For example, an exchange may require a memo, destination tag or message when you are sending it to them.

For deposits of tag-based assets to Zero Hash, the memo, destination tag or message is required. This rule ALSO applies to any token that uses that base chain such as a USDC asset on a tag or memo based blockchain.

Tagged based asset

Name	Asset	Type	Required on deposits?	Required on withdrawals?
EOS	EOS	Memo	Yes	Optional
Stellar	XLM	Memo	Yes	Optional
NEM	XEM	Message	Yes	Optional
Ripple	XRP	Destination Tag	Yes	Optional
Hedera	HBAR	Memo	Yes	Optional

For more details on these assets, you can check the Supported Assets & Instruments page.

When do you need to provide a memos, destination tags and messages?

For some non-custodial wallet providers or externally-owned wallets, a memo / destination tag / message is optional when you withdraw assets. It is always recommended to check and verify this with your wallet provider first.

If a memo / destination tag / message is needed, please make sure you enter the correct information where needed, as incorrect information could lead to loss of funds. To be even safer, you can always test with a small amount to be sure that your transaction goes through.

How a memos, destination tags and messages looks like on requests?

If you run GET /deposits/digitial_asset_addresses endpoint on any of memo/destination/message tagged based assets in the above list, you will see the below response:

The memo/destination tag id would be displayed after your address, and this is the id you need to use when submitting withdrawals, more details on withdrawals, see the below section for details.

How to provide a memo, destination tag or message when withdrawing funds in Zero Hash

Withdrawal account creation via the client portal.
1. When you create a new withdrawal address for the above asset using the client portal, you will be asked to enter either Memo ID or Destination Tag on the screen:

Create a Withdrawal request via API.

When using request POST /withdrawals/requests endpoint with a defined withdrawal address, two related request parameters need to be used to provide the additional information for those assets:

Parameter Name	Description	How to Use It
`no_destination_tag`	It is a Boolean field to show whether or not the specific withdrawal and destination address requires a destination tag or memo ID.	If not required, please set this field to be true; otherwise false
`destination_tag`	The destination tag or memo ID associated with the transaction.	If `no_destination_tag` is false, then this field needs to be populated with the correct memo id or destination tag. If `no_destination_tag` is true, this field is not required.

For more details regarding this endpoint, please check the withdrawal section of our API documentation.