How to Create a Token on the XRP Ledger: Step-by-Step Guide (2026)

Disclosure: This article may contain affiliate links. We may earn a commission if you sign up through our links, at no extra cost to you.

Token Issuance on the XRP Ledger

The XRP Ledger has supported token issuance (called “issued currencies” or “IOUs”) since its launch. Unlike Ethereum, where you deploy an ERC-20 smart contract, XRPL token issuance is a native ledger feature — no smart contract code required. This makes it simpler, cheaper, and less prone to smart contract vulnerabilities.

Any XRPL account can issue tokens, but the mechanism revolves around trust lines — the receiver must explicitly trust the issuer before they can hold the token.

XRP Ledger Token Standards

The XRPL implements tokenization through a standardized protocol rather than individual smart contracts. This standardization ensures:

• Atomic composability: All XRPL tokens can interact seamlessly with the ledger’s native features, including the decentralized exchange and payment channels
• Fixed gas costs: Token transactions consume predictable amounts of XRP (typically 0.00001 XRP per operation)
• Native interoperability: Any two issued currencies can be traded directly through the XRPL DEX without wrapping or bridging

Prerequisites

• Two XRPL accounts: An issuer account (cold wallet) and a distribution account (hot wallet). Best practice is to separate these for security.
• XRP reserve: Each account needs the base reserve (currently 10 XRP) plus additional reserves for trust lines and offers.
• XRPL client library: xrpl-py (Python), xrpl.js (JavaScript), or direct API calls to an XRPL node.

Token Economics Considerations

Supply Management

XRPL tokens differ from traditional blockchain tokens in their accounting model:

• Issued tokens represent liabilities on the issuer’s balance sheet (negative balances)
• The total supply equals the sum of all positive balances held by counterparties
• Burning tokens requires sending them back to the issuer, where they cancel out the liability

Transaction Fees

While XRP pays for network fees, token issuers can implement their own fee structures:

• Transfer fees (0-100%) can be set and modified by the issuer
• Exchange fees apply when trading on the DEX (default 0% but configurable per issuer)
• Custom fee structures can be built using hooks (post-v2.1.0 functionality)

Step 1: Create the Issuer Account

Generate a new XRPL keypair for the issuer account. Fund it with enough XRP for the base reserve plus anticipated trust line reserves. This account will be the permanent issuer of your token.

Security tip: The issuer account’s private key should be stored offline (cold storage) after initial configuration. All routine operations should use the distribution account.

Step 2: Configure the Issuer Account Settings

Set the following flags on the issuer account using an AccountSet transaction:

• DefaultRipple: enabled — allows your token to be traded between holders (essential for DEX trading)
• DisallowXRP: optional — prevents accidental XRP sends to the issuer account
• RequireAuth: optional — if enabled, you must approve each trust line (useful for regulated tokens)

Step 3: Create a Trust Line

The distribution account creates a trust line to the issuer account for the token currency code. The trust line specifies:

• Currency code: 3-character ISO-style code (e.g., “USD”, “EUR”) or a 40-character hex code for custom names
• Limit: The maximum amount the distribution account is willing to hold

Step 4: Issue the Token

The issuer account sends a Payment transaction to the distribution account, creating the tokens. On the XRPL, tokens are created at the moment of payment — there’s no separate “mint” operation. The issuer’s balance goes negative (representing a liability), and the receiver’s balance goes positive.

Step 5: Distribute to Holders

From the distribution account, you can send tokens to any XRPL address that has set up a trust line to your issuer. You can also place offers on the XRPL’s native DEX to make your token tradable against XRP or other issued currencies.

Token Settings and Advanced Features

• Transfer fees: The issuer can set a transfer fee (0–100%) that is collected on every transfer between third parties
• Freeze: Issuers can freeze individual trust lines or enable a global freeze — useful for regulated assets
• Clawback: A newer XRPL feature allowing issuers to reclaim tokens from holders (required for some regulatory compliance)
• No Ripple flag: Controls whether tokens can “ripple” through the issuer account between holders

Best Practices

1. Use separate issuer and distribution accounts — never expose the issuer’s private key for routine operations
2. Set a meaningful currency code — 3-char codes are human-readable; hex codes allow longer names
3. Enable DefaultRipple — otherwise your token won’t be tradable on the DEX
4. Document your token — use the xrp-ledger.toml file to associate your domain with your issuer address
5. Consider regulatory requirements — if your token represents a security or regulated asset, use RequireAuth and Freeze capabilities

Conclusion

Creating a token on the XRPL is straightforward compared to deploying smart contracts on Ethereum. The native trust line and issuance mechanism provides security guarantees built into the ledger itself. Whether you’re tokenizing a real-world asset, creating a community token, or building a stablecoin, the XRPL provides the infrastructure to launch with minimal technical overhead.

This article is for informational purposes only and does not constitute financial advice. Always do your own research and consult legal counsel before issuing tokens.