XRPL.to
Insights

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 25 account 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.

Balance
/account/balance/:account
Trustlines
/trustlines/:account
Transactions
/account/tx/:account
DEX Offers
/account/offers/:account
NFTs
/account/nfts/:account
Objects
/account/objects/:account

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.

Request
curl "https://api.xrpl.to/v1/account/balance/rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De?rank=true"
Response
{
  "success": true,
  "account": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
  "balance": 94.97836,
  "total": 99.77836,
  "reserve": 4.800000000000001,
  "ownerCount": 19,
  "sequence": 89926470,
  "inception": "2024-08-08T20:55:31.000Z",
  "rank": 2114036
}
Live for RLUSD's issuer, refreshed hourly, trimmed: balance is the spendable XRP, total includes the reserve, and rank is the account's place among all XRP balances.

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/rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De

Each trustline entry contains the currency code, issuer address, balance, limit, USD value, and token name when available.

Transaction History

Fetch an account’s full transaction history, newest first. Each page returns a marker; pass it back to get the next page. types filters by transaction type (Payment, OfferCreate, TrustSet, NFTokenMint and so on), and forward=true starts from the oldest.

curl "https://api.xrpl.to/v1/account/tx/rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De?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/rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De

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/rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De

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/rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De

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..."]}'

Attribution Is Required

The API is free to call, but not unconditional. Any app, website, bot or dashboard that displays xrpl.to data must show a visible, clickable Data by xrpl.to credit on the same screen as that data — not buried in an about page. This applies on every tier, including calls made with no API key. Storing our data and re-serving it from your own API or dataset needs written permission first. Full terms are in the API documentation.

Build a Wallet App

Combine these endpoints with WebSocket streams to build full-featured wallet applications with live balance updates:

API DocumentationWebSocket StreamsBuild a Trading App