Account
One wallet: balances, trust lines, offers, transactions, NFTs and trading stats, and its xrpl.to profile.
An account is its r-address, e.g. rN7n3473SaZBCG4dFL83w7a1RXtXtbk2D9.
Details and names
Balances and trust lines
- GET
/v1/account/balance/{account}XRP balance with reserves - POST
/v1/account/balanceBatch balance lookup (max 100) - GET
/v1/account/balance/pair/{account}Token pair balances - GET
/v1/account/trustlines/{account}Account trustlines - GET
/v1/trustlines/{account}Trustlines with token values - GET
/v1/account/trustline/{account}/{issuer}/{currency}Single trustline lookup - GET
/v1/account/currencies/{account}Sendable/receivable currencies - GET
/v1/account/gateway/{account}Gateway balances (issuer totals) - GET
/v1/account/snapshot/{account}Point-in-time XRP + token holdings valued in XRP at a historical ledger (resolve time to ledger via /ledger/at first)
Offers
Transactions
NFTs
Trading stats
- GET
/v1/traders/{account}Full trader profile - GET
/v1/traders/{account}/rotationsPer-account token rotation flow (XRP bought/sold per token in window) - GET
/v1/token/analytics/trader/{address}Trader cumulative stats - GET
/v1/token/analytics/trader/{address}/tokensTrader token-specific metrics - GET
/v1/token/analytics/trader/{address}/historyTrader volume history - GET
/v1/token/analytics/trader/{address}/tradesTrader trade history - GET
/v1/account/token-stats/{account}/{md5}Per-token trading stats for account - GET
/v1/account/recent-trades/{account}Recent trades for an account - GET
/v1/lp-positions/{account}AMM LP positions with impermanent loss analysis - GET
/v1/nft/analytics/trader/{account}Single NFT trader profile - GET
/v1/nft/analytics/trader/{account}/historyTrader daily history - GET
/v1/nft/analytics/trader/{account}/collectionsTrader per-collection breakdown - GET
/v1/nft/analytics/trader/{account}/tradesTrader trade history - GET
/v1/nft/analytics/trader/{account}/rotationsNFT trader rotations history - GET
/v1/nft/traders/{account}/volumeTrader volume stats
Ledger objects
Watchlists
xrpl.to profiles
Profiles, badges, labels and tiers are xrpl.to member data, not ledger data.
- GET
/v1/user/tiersUser tiers with pricing (member, vip, nova, diamond, verified) - GET
/v1/user/{account}Get user profile - POST
/v1/user/{account}wallet signatureCreate user profile - GET
/v1/user/{account}/perksResolved perks (tier + roles merged) - GET
/v1/user/{account}/badgesAll unlocked badges - GET
/v1/user/{account}/labelswallet signature (owner only)Get your own wallet labels — private data, owner-authenticated - GET
/v1/user/badges/metaBadge system metadata - GET
/v1/user/badges/{badge}/holdersUsers holding a specific badge - PUT
/v1/user/{account}wallet signatureUpdate username (VIP+ required to change an existing one; tier field is admin-only) - PUT
/v1/user/{account}/display-badgewallet signatureSet displayed badge (must be unlocked) - GET
/v1/user/{account}/labels/watchedwallet signature (owner only)Only actively-watched wallet labels — private data, owner-authenticated - POST
/v1/user/{account}/labelswallet signatureCreate/update a wallet label (per-tier cap; 402 when limit reached) - PUT
/v1/user/{account}/labels/{wallet}/watchwallet signatureToggle live-watch on a label (per-tier watcher cap) - DELETE
/v1/user/{account}/labels/{wallet}wallet signatureDelete a wallet label - PUT
/v1/user/{account}/avatarwallet signatureSet avatar from an owned NFT - POST
/v1/user/tier/purchaseCreate XRP invoice for user tier (expires 30 min) - GET
/v1/user/tier/verify/{invoiceId}Verify tier XRP payment (scans fee collector; expired invoices honored if exact payment exists) - POST
/v1/user/tier/stripeStripe checkout for user tier - GET
/v1/user/tier/stripe/{sessionId}Check Stripe tier payment status - POST
/v1/user/tier/gift/purchaseGift a tier via XRP invoice - GET
/v1/user/tier/gift/verify/{invoiceId}Verify gift tier payment - POST
/v1/user/tier/gift/stripeGift a tier via Stripe - POST
/v1/account/resolveBatch-resolve admin-verified destination identity (name, logo, tagRequired). Only verified accounts are returned — absence means unknown, which is the safety signal. - GET
/v1/account-thumb/{address}Admin-set account logo image bytes (404 when unset)