---
id: xrpl-py
version: "5.0.0"
license: ISC
license_treatment: permissive
maintenance: active
---

# xrpl-py — A complete Python library for interacting with the XRP ledger

License: permissive · Maintenance: active · Downloads: 147.3K/mo

## 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 above — 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

pip install xrpl-py
uv add xrpl-py
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_current
- Install friction: low
- Maintenance: active
- Downloads: 147.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

xrp ledger python client, cryptocurrency transaction signing, xrpl wallet management, blockchain ledger interaction, xrp payment library, ledger serialization python, xrpl network client, cryptocurrency, blockchain, xrp-ledger

[View on SkillFed](https://skillfed.io/packages/xrpl-py) · [View on PyPI](https://pypi.org/project/xrpl-py/)