xrpl-py
A complete Python library for interacting with the XRP ledger
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-pyuv
uv add xrpl-pypoetry
poetry add xrpl-pyInstalling 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
Tags
More Internet packages
Botocore provides low-level, data-driven access…
permissive · top 100 on PyPI
aiobotocoreProvides an async client for AWS services using…
permissive · top 100 on PyPI
pydanticPydantic validates Python data structures…
permissive · top 100 on PyPI
filelockProvides a platform-independent file locking…
permissive · top 100 on PyPI
fastapiFastAPI is a Python web framework for building…
permissive · top 100 on PyPI
googleapis-common-protosProvides common Protocol Buffer message…
permissive · top 100 on PyPI
web3web3.py is a Python library for interacting…
permissive · top 5,000 on PyPI
cdp-sdkPython client library for the Coinbase…
permissive · top 15,000 on PyPI
rlpEncodes and decodes data using Recursive Length…
permissive · top 5,000 on PyPI
base58Encodes and decodes data using Base58 and…
permissive · top 5,000 on PyPI
eth-accounteth-account signs Ethereum transactions and…
permissive · top 5,000 on PyPI
tronpytronpy is a Python client library for…
permissive · top 15,000 on PyPI
py-builder-relayer-clientA Python client library for submitting…
permissive · top 15,000 on PyPI
x402Implements the x402 payment protocol with…
permissive · top 15,000 on PyPI
tigerbeetlePython client library for TigerBeetle, a…
permissive · top 15,000 on PyPI
python-bitcoinlibProvides low-level Python tools to work with…
copyleft · top 15,000 on PyPI