XRP - Account not found

When interacting with the XRP blockchain to fetch an address balance, you may encounter the following error:

{
    'statusCode': 403,
    'errorCode': 'xrp.account.failed',
    'message': 'Account not found. Code: 19'
}

To have an XRP account, an address must hold a minimum amount of XRP in the shared global ledger. To fund a new address, you must receive enough XRP at that address to meet the reserve requirement.

Current reserve requirements (as of 2024-12-02)

• Base Reserve: 1 XRP per account (down from 10 XRP).
• Owner Reserve Increment: 0.2 XRP per item (down from 2 XRP).

Resolving the Error

1. Fund the Account
   • To create an XRP Ledger account, send at least 1 XRP to the address.
   • Use a wallet or service that supports XRP transactions to perform this transfer.
   • If you expect the account to hold ownership items (trustlines, offers, etc.), send additional XRP to meet the reserve requirements.
2. Verify the Address
   • Confirm that the XRP Ledger address is correctly formatted and intended for the appropriate network (mainnet or testnet).
   • Addresses typically start with an r and are case-sensitive.
3. Check Network Fees and Funding
   • Ensure you account for transaction fees (10 drops per transaction) when funding the account.
   • Verify that the total amount sent meets the base reserve and any owner reserve increments if applicable.

📘

Info

For more details about XRP reserve requirements and recent updates, refer to the official XRP documentation.