Check MPT balances

Once a ticker exists for an MPT (created automatically or manually), you can view balances using the standard Ripple Custody (Vault) balance APIs and UI.

Prerequisites

Prerequisite	Additional information
An authorized MPT	Authorize MPT
A ticker for the MPT	Created automatically on first receipt, or create manually

View balances

Use the standard balance APIs to view MPT balances:

Check account balances

Ripple Custody (Vault) applies the MPT's AssetScale to display balances with correct decimal precision.

Create an MPT ticker

When an incoming MPT payment is received, Ripple Custody (Vault) automatically creates a ticker. You can also explicitly create a ticker using the v0_CreateTicker intent:

Payload example

{
  "payload": {
    "ledgerId": "xrpl-mainnet",
    "kind": "Token",
    "name": "MyMultiPurposeToken",
    "decimals": 6,
    "symbol": "MMPT",
    "ledgerDetails": {
      "type": "XRPL",
      "properties": {
        "type": "MultiPurposeToken",
        "issuanceId": "000004C463C52827307480341125DA0577AFFC21D4B2D083"
      }
    },
    "type": "v0_CreateTicker"
  }
}

Properties fields

Field	Type	Description
`type`	string	Must be `MultiPurposeToken`.
`issuanceId`	string	The 192-bit MPT Issuance ID (hex encoded). Pattern: `^[A-Fa-f0-9]{48}$`.

The ticker's decimals field should match the MPT's AssetScale for correct balance display.