XRPL Wallet API: Account Balance, History & Token Holdings
Query any XRPL account for balances, token holdings, transaction history, NFTs, and open DEX offers with a single API call.
Wallet Data Endpoints
The XRPL.to API provides over 20 account-related endpoints that return processed, enriched data for any XRP Ledger address. Unlike raw rippled responses, these endpoints include USD valuations, token metadata, and paginated results ready for display.
Account Balance
Retrieve the XRP balance, reserve breakdown, spendable amount, and global rank for any account. The response includes both raw drops and formatted XRP values.
curl https://api.xrpl.to/v1/account/balance/rHfEXXUTYJpn485a2opwf75gKro4XrpLTo
Response includes balance, reserve, spendable, ownerCount, and rank fields.
Token Holdings
Get all trustlines for an account, including token balances with current USD values, issuer details, and token metadata. Useful for portfolio displays.
curl https://api.xrpl.to/v1/trustlines/rHfEXXUTYJpn485a2opwf75gKro4XrpLTo
Each trustline entry contains the currency code, issuer address, balance, limit, USD value, and token name when available.
Transaction History
Fetch the full transaction history for any account with pagination. Transactions are parsed and categorized by type (Payment, OfferCreate, TrustSet, NFTokenMint, etc.).
curl "https://api.xrpl.to/v1/account/tx/rHfEXXUTYJpn485a2opwf75gKro4XrpLTo?page=1&limit=20"
Open DEX Offers
List all open offers (limit orders) placed by an account on the XRPL DEX. Includes the trading pair, price, amount, and sequence number for each offer.
curl https://api.xrpl.to/v1/account/offers/rHfEXXUTYJpn485a2opwf75gKro4XrpLTo
NFT Holdings
Retrieve all NFTokens owned by an account, including collection details, metadata URIs, and marketplace listing status.
curl https://api.xrpl.to/v1/account/nfts/rHfEXXUTYJpn485a2opwf75gKro4XrpLTo
Account Objects
Query all ledger objects owned by an account, including escrows, payment channels, checks, and deposit pre-authorizations. Useful for building comprehensive account views.
curl https://api.xrpl.to/v1/account/objects/rHfEXXUTYJpn485a2opwf75gKro4XrpLTo
Batch Lookups
Need to check balances for multiple accounts at once? The batch endpoint accepts up to 100 addresses in a single POST request, reducing round trips for portfolio aggregation or whale tracking tools.
curl -X POST https://api.xrpl.to/v1/account/balance \
-H "Content-Type: application/json" \
-d '{"accounts": ["rAddress1...", "rAddress2...", "rAddress3..."]}'Build a Wallet App
Combine these endpoints with WebSocket streams to build full-featured wallet applications with live balance updates: