Learn how to connect your XRP Ledger (XRPL) wallet to Hummingbot, configure the necessary settings, and run a simple market-making strategy on the XRPL decentralized exchange. This guide is designed for both beginners and developers, providing clear instructions for each step of the process.
Prerequisites
Before you begin, make sure you have Hummingbot installed on your system. No prior coding experience is necessary, as most commands can be copied and pasted directly.
Creating an XRPL Wallet
You can generate your XRP Ledger wallet credentials using one of two methods: a beginner-friendly faucet or a developer-oriented terminal script.
Using the XRPL Testnet Faucet
Visit the official XRPL Testnet Faucet to generate your wallet credentials easily.
Select Testnet from the dropdown menu and click the Generate Testnet Credentials button.
Copy the provided Wallet Address and Secret Key, storing them in a secure location.
Remember: your Secret Key (also known as your seed) provides full access to your wallet. Keep it confidential to prevent unauthorized access to your funds.
Generating Wallet via Terminal Script
For those comfortable with command-line tools, open your terminal (Linux, macOS, or WSL on Windows) and run:
curl -s https://gist.githubusercontent.com/david-hummingbot/a040f9af46b5d627f9437f04a04fc4ec/raw/1aab1f428b834eafcdc06a1c88d6dbd47afbf551/create_xrp_wallet.sh | bashThe script will output four lines of information including your wallet address and seed. Save all this information securely.
If you encounter dependency issues during installation, use the faucet method instead.
Setting Up Xaman Wallet
Xaman (formerly XUMM) is a popular mobile wallet for interacting with the XRP Ledger. Download and install the app from your device's app store.
Once installed, you'll need to import your XRPL account.
Importing Your XRPL Account into Xaman
Open Xaman and navigate to Settings > Accounts > Add account.
Select Import an existing account and choose between:
- Full access: Allows complete control including transaction signing
- Read-only access: For monitoring account activity only
For trading purposes, select Full access and choose Family Seed as your import method.
Enter your 29-character seed (starting with 's') and verify that the displayed address matches your intended account. Complete the security setup and account labeling process to finalize the import.
Connecting Your Wallet to Hummingbot
Launch Hummingbot and run the connect xrpl command.
When prompted, provide:
- Your wallet secret key (the seed starting with 's')
- XRPL node URL(s) (use defaults or your private nodes)
After connecting, run the balance command to verify your connection and view your XRPL balances:
Symbol Balance
RLUSD 23.4359
XRP 138.2416Configuring the XRPL Connector
Hummingbot creates a configuration file at /conf/connectors/xrpl.yml that contains your encrypted credentials and market settings.
The file includes custom market definitions such as:
custom_markets:
XRP-RLUSD:
base: XRP
quote: RLUSD
base_issuer: ""
quote_issuer: "rhub8VRN55s94qWKDv6jmDy1pUykJzF3wq"Configuring XRPL Nodes
The default public node (wss://s1.ripple.com/) may experience rate limiting during high traffic periods. For better performance, consider using private node providers or alternative public nodes.
👉 Explore more strategies for optimizing your node configuration and trading performance.
Implementing a Simple PMM Strategy
To run a Passive Market Making (PMM) strategy on the XRPL DEX, ensure your connector is properly connected and funded.
Creating Configuration Files
Use the create --script-config simple_pmm command in Hummingbot to generate a default configuration file. Edit this file with your preferred parameters:
script_file_name: simple_pmm.py
exchange: xrpl
trading_pair: XRP-RLUSD
order_amount: 15
bid_spread: 0.001
ask_spread: 0.001
order_refresh_time: 120
price_type: midThis configuration creates a market-making strategy that:
- Places buy orders 0.1% below the mid-market price
- Places sell orders 0.1% above the mid-market price
- Refreshes orders every 120 seconds
Starting the Trading Bot
Execute your strategy with:
start --script simple_pmm.py --conf conf_simple_pmm_test-xrp-rlusd.ymlMonitor the log pane for order placement confirmations and any error messages that may require troubleshooting.
Frequently Asked Questions
What is the difference between Testnet and Mainnet on XRPL?
Testnet is a testing environment that uses fake XRP for practice and development, while Mainnet involves real XRP and actual financial value. Always use Testnet when learning and testing strategies.
How do I ensure the security of my XRPL wallet?
Never share your secret key or seed phrase, use secure storage methods like password managers, and enable all available security features in your wallet app. Regularly monitor your account activity for any unauthorized transactions.
What should I do if my orders aren't being placed?
Check your connection status with the balance command, verify your configuration parameters, and ensure you have sufficient funds for the order amounts specified. Also confirm that your node connection is active and responsive.
Can I use multiple trading pairs with Hummingbot on XRPL?
Yes, you can configure multiple trading pairs in your connector configuration file. Each pair requires proper base and quote issuer information, especially for tokens that aren't XRP.
How often should I update my node configuration?
Regularly review your node performance and update your configuration if you experience connectivity issues or slow response times. The decentralized nature of XRPL means node availability can change over time.
What resources are available if I need additional help?
The trading community offers various support channels and documentation for both beginners and advanced users. Many successful traders share their experiences and solutions to common challenges.