Using XRP Ledger with Hummingbot: A Comprehensive Guide

What You’ll Learn

This guide will walk you through the process of integrating the XRP Ledger (XRPL) with Hummingbot for automated trading. By the end, you’ll be able to:

Create an XRPL wallet using beginner-friendly or developer-oriented methods.
Import your wallet into Xaman (formerly XUMM) for secure management.
Link your XRPL wallet to Hummingbot and verify your balance.
Customize the XRPL connector by adding private nodes or custom markets.
Execute a Simple PMM strategy on the XRPL decentralized exchange (DEX).

Creating an XRPL Wallet

There are two primary ways to generate your XRP wallet credentials:

Beginner-Friendly Method: XRPL Testnet Faucet

Visit the XRPL Testnet Faucet.
Select Testnet and click Generate Testnet Credentials.
Securely store your Wallet Address and Secret Key.

⚠️ Important: Never share your Secret Key—it grants full access to your funds.

Developer-Friendly Method: Automated Script

Run this terminal command to generate a wallet programmatically:

curl -s https://gist.githubusercontent.com/david-hummingbot/a040f9af46b5d627f9437f04a04fc4ec/raw/1aab1f428b834eafcdc06a1c88d6dbd47afbf551/create_xrp_wallet.sh | bash

The script outputs four lines of credentials. Save these securely.

Setting Up Xaman (Mobile Wallet)

Download Xaman from official stores:

For installation help, refer to Xaman’s official guide.

Importing Your XRPL Account into Xaman

Open Xaman and navigate to Settings > Accounts > Add Account.
Select Import an existing account.
Choose Full access and enter your Family Seed (29-character string starting with s).
Confirm the displayed wallet address matches your intent.

🔐 Security Tip: Family Seeds are equivalent to private keys—handle with extreme caution.

Connecting Your Wallet to Hummingbot

Launch Hummingbot and run connect xrpl.
Provide your Secret Key and preferred XRPL node URLs.
Verify connectivity with the balance command. Example output:

Symbol  Balance
RLUSD   23.4359
XRP     138.2416

👉 Need a reliable node provider? Try these recommendations

Customizing the XRPL Configuration

Edit /conf/connectors/xrpl.yml to:

Add private nodes (recommended for rate-limiting avoidance).
Define custom markets. Example snippet:

custom_markets:
  XRP-RLUSD:
    base: XRP
    quote: RLUSD
    quote_issuer: "rhub8VRN55s94qWKDv6jmDy1pUykJzF3wq"

Node Providers

Public nodes are listed here.

Running a Simple PMM Strategy

Configuration

Create a simple_pmm config with these key fields:

Field	Value	Description
`exchange`	`xrpl`	Trading platform.
`trading_pair`	`XRP-RLUSD`	Token pair (base-quote).
`order_amount`	`15`	Quantity per order.
`bid_spread`	`0.001`	Buy order placement (% below mid-price).
`ask_spread`	`0.001`	Sell order placement (% above mid-price).

Launching the Bot

Run:

start --script simple_pmm.py --conf conf_simple_pmm_test-xrp-rlusd.yml

Monitor the log pane for real-time updates.

FAQ

How do I troubleshoot connectivity issues?

Ensure your node URL is active and credentials are correctly entered. Use balance to test.

Can I trade on mainnet?

Yes—replace Testnet credentials with mainnet keys and nodes.

What’s the minimum XRP balance required?

The XRPL reserves 10 XRP per wallet. Factor this into your funding.

👉 Explore advanced strategies in Hummingbot’s docs

Final Thoughts

This guide equips you to trade programmatically on the XRPL DEX using Hummingbot. For community support, join the Hummingbot Discord. Happy trading!