skillfed

xrpl-py

A complete Python library for interacting with the XRP ledger

xrpl-py v5.0.0 147.3K downloads/30d#11,071 on PyPI241
Permissive license ISC Active released

What it is and what it does

xrpl-py is a Python client library for the XRP Ledger, a distributed ledger for payments and financial transactions. It abstracts away the complexity of XRP Ledger interaction by providing native Python models for transactions, wallet management, and API requests. The library handles serialization of data into the ledger's canonical format, transaction signing with private keys, and communication with rippled nodes via JSON-RPC or WebSocket. It includes utilities for key derivation, address generation, balance queries, and reliable transaction submission with built-in retry logic.

The library targets developers building cryptocurrency applications, trading bots, payment processors, or financial services on the XRP Ledger. It requires Python 3.10 or later and depends on cryptographic libraries (pycryptodome, ECPy), HTTP clients (httpx, websockets), and encoding utilities (base58). The fact sheet shows no known vulnerabilities and active maintenance.

Use it for:

  • Build a payment application that sends XRP between accounts with automatic fee calculation and transaction signing.
  • Generate and manage XRP Ledger wallets programmatically, including seed-based and testnet faucet-based wallet creation.
  • Query account balances, transaction history, and ledger state from a rippled node.
  • Implement a trading bot that submits orders or payment transactions to the XRP Ledger with reliable delivery guarantees.
  • Serialize and sign transactions locally before broadcasting them to the network for production use cases.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A pure Python library for building applications that interact with the XRP Ledger, handling wallet management, transaction signing, serialization, and network communication.

Yes. The library is actively maintained, has no known vulnerabilities, uses a permissive license, and installs with low friction. It is the standard Python client for XRP Ledger development. Install it if you are building any application that needs to interact with the XRP Ledger or manage XRP accounts programmatically.

Install

xrpl-py on PyPI

pip

pip install xrpl-py

uv

uv add xrpl-py

poetry

poetry add xrpl-py

Installing xrpl-py

Before you install

Low friction: pure Python wheel with no compiled dependencies. Actively maintained with a recent release (72 days ago) and steady repository activity. Eight runtime dependencies are all standard cryptography and HTTP libraries.

License in practice

ISC permissive license allows commercial and private use with minimal restrictions, making it suitable for production applications without licensing concerns.

Quickstart

pip install xrpl-py

from xrpl.clients import JsonRpcClient
from xrpl.wallet import generate_faucet_wallet
from xrpl.models import Payment
from xrpl.transaction import submit_and_wait

client = JsonRpcClient("https://s.altnet.rippletest.net:51234")
wallet = generate_faucet_wallet(client)
payment = Payment(account=wallet.address, amount="1000", destination="rN7n7otQDd6FczFgLdlqtyMVrn3Rqq5Qxo")
response = submit_and_wait(payment, client, wallet)

Requires Python 3.10 or later. Testnet examples require network access to a rippled node endpoint.

Verify before relying

  • Whether the library's transaction signing methods meet production security audits or compliance standards for financial applications.
  • Performance characteristics when submitting high-volume transactions or querying large account histories.

Package facts

License ISC (permissive)
Python support supports the current Python release (>=3.10)
Install friction low — pure-Python wheel
Runtime dependencies 8 — Deprecated, ECPy, base58, httpx, pycryptodome, types-Deprecated, typing-extensions, websockets
Maintenance actively maintained — 72 days since the last release
Last repo commit
First released
Downloads 147,303/month — #11,071 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities none known (OSV.dev, checked 2026-08-14)

Evidence: xrpl_py-5.0.0-py3-none-any.whl

Keywords: xrp, xrpl, cryptocurrency

License :: OSI ApprovedProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13

Tags

xrp ledger python clientcryptocurrency transaction signingxrpl wallet managementblockchain ledger interactionxrp payment libraryledger serialization pythonxrpl network client
cryptocurrencyblockchainxrp-ledger

More Internet packages