Create an MPT issuance

Create a new Multi-Purpose Token (MPT) issuance on the XRP Ledger.

• An XRPL account registered in Ripple Custody (Vault)
• Sufficient XRP for reserves (owner reserve + issuance reserve)

To create an MPT:

1. Go to Accounts and open the account that will issue the token.

2. Click Create order and select Ledger-specific operations.

3. In Ledger, select the XRP Ledger network. Source account is set to the current account.

4. In Operation, select Create token.

5. Under Token details, enter the token's XLS-89 metadata:

   

   Field	Description	Required
   Issuer name	The name of the entity that issues the token.	Yes
   Name	The token's display name.	Yes
   Symbol	The token's ticker.	Yes
   Asset class	The token's primary purpose: Defi, Gaming, Memes, Real-world asset, Wrapped, or Other.	Yes
   Asset subclass	The type of real-world asset: Commodity, Equity, Private credit, Real estate, Stablecoin, Treasury, or Other. Shown only when Asset class is Real-world asset.	Conditional
   Icon	The URI of the token icon. Enter a hostname and path (HTTPS is assumed) or a full URI for other protocols.	Yes
   Description	A long description of the token.	No

6. Set the supply and the flags:

   

   Field	Description
   Decimals (asset scale)	The number of decimal places, from 0 to 20. For example, 2 gives a precision of 0.01. If you leave it empty, the token can't be divided below 1 unit.
   Supply cap	The maximum number of whole tokens in circulation. The cap applies before the asset scale, so a cap of 100 with 2 decimals allows 100.00 tokens. Leave it empty for no cap.
   Can transfer	Holders can transfer the token to each other. When you turn this on, the Transfer fee field appears.
   Transfer fee	The percentage fee, from 0 to 50%, that holders pay when they transfer the token to each other. It doesn't apply to transfers to the issuer.
   Can trade	The token can be traded on the DEX.
   Can escrow	The token can be placed in escrow.
   Can lock	You can freeze one or all holders.
   Can clawback	You can claw back tokens from holders.
   Require authorization	Holders need your authorization before they can hold the token.

7. Optional: Under URIs, click Add URI to link resources such as a website or documentation. For each URI, enter a Title, a Category (Docs, Social, Website, or Other), and the full HTTPS or IPFS URI. You can't update URIs after the token is created.

8. Optional: Under Additional information, click Add additional information to add label and value pairs such as an interest rate or maturity date.

   

9. Select a Fee Strategy, and optionally set a maximum fee or add a description.

10. Click Submit for approval and sign the operation with the app. The signing window shows the operation as MPT Issuance Create with the metadata and flags you entered.

    

When the intent is approved, Ripple Custody (Vault) submits the transaction. To follow it, go to Transactions, open the transaction, and check that Custody Status is Completed and Ledger Status is Confirmed. ID on ledger is the transaction hash.

The ledger assigns the issuance ID when the transaction is confirmed. You need this ID to perform other operations on the token until the token is registered in Ripple Custody (Vault). To find it, look up the transaction by its ID on ledger in an XRPL explorer and read mpt_issuance_id from the transaction metadata.

The SDK examples assume a configured client. See Integrate via SDK.

To create an MPT, submit a transaction order with the MPTokenIssuanceCreate operation:

{
  "payload": {
    "id": "{{intent_id}}",
    "accountId": "{{issuer_account_id}}",
    "ledgerId": "xrpl-testnet",
    "parameters": {
      "type": "XRPL",
      "feeStrategy": {
        "priority": "High",
        "type": "Priority"
      },
      "maximumFee": "1000000000",
      "memos": [],
      "operation": {
        "type": "MPTokenIssuanceCreate",
        "assetScale": 6,
        "transferFee": 0,
        "maximumAmount": "1000000000000000",
        "metadata": {
          "type": "HexEncodedMetadata",
          "value": "7B226E223A224D7920546F6B656E222C2264223A22546F6B656E206465736372697074696F6E227D"
        },
        "flags": ["tfMPTCanTransfer", "tfMPTCanTrade", "tfMPTCanClawback", "tfMPTCanLock"]
      }
    },
    "description": "MPTokenIssuanceCreate intent",
    "customProperties": {},
    "type": "v0_CreateTransactionOrder"
  }
}

For a complete program, see the XRPL MPT example: 48 in TypeScript, 49 in Python, or 51 in Java. To get the examples, see Examples.

In the SDKs, you pass metadata as the hex string only, and the SDK wraps it in the HexEncodedMetadata object.

The metadata field must be an object with the following structure:

Set these flags during creation to control token behavior. These flags are immutable after creation.

A successful request returns the transaction order with status Pending. The transaction includes the generated MPTIssuanceID in the on-chain result after confirmation.

After the transaction is confirmed, retrieve the issuance ID from the transaction result:

1. Query the transaction order by ID.
2. Extract the MPTIssuanceID from the ledger result.

The SDKs read the ID for you. Pass the result of waiting for the transaction hash to extractMptIssuanceId (TypeScript), Transactions.extractMptIssuanceId (Java), or extract_mpt_issuance_id (Python), as shown in Create an MPT issuance with the API.

The issuance ID is a 192-bit identifier (48 hex characters) used to reference the MPT in all subsequent operations.

• Multi-purpose tokens — Overview of MPT operations.
• Multi-purpose tokens concepts — Conceptual information about MPTs.
• Mint tokens — Issue tokens to holders.
• Token flags — Flag descriptions and risk impact.
• MPTokenIssuanceCreate — XRPL transaction reference.