{"uid":"cap_I1ckxnRuoHe4iAuzwc39M","slug":"xrpl-account-read-balance-reserve-spendable-trustlines-flags-d05073f8","name":"XRPL Account Read — Balance, Reserve, Spendable, Trustlines, Flags","description":"XRPL account read — balance, reserve, spendable, trustlines, flags — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/xrpl-account?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"account":{"type":"string","pattern":"^r[1-9A-HJ-NP-Za-km-z]{24,34}$"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"xrpl-account","flags":{"deposit_auth":false,"require_dest_tag":false},"found":true,"network":"xrpl:mainnet","receipt":{"tx_hash":"0x<64hex>","amount_usd":0.008,"receipt_id":"g402-<16hex>"},"trustlines":[{"frozen":false,"issuer":"rNep…FS4","balance":"969998000","currency":"UNY"}],"balance_xrp":"8.341856","owner_count":6,"reserve_xrp":"2.2","ledger_index":107117487,"spendable_xrp":"6.141856"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_o6oKSHQd0YW-iLvbxtOWq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches full account state from the XRP Ledger mainnet: XRP balance, reserve, spendable amount, trustlines, owner count, and account flags for a given XRPL address.","exampleAgentPrompt":"Can you check the XRP Ledger account rNepFS4... for me — I want to know the current XRP balance, how much is spendable after reserves, and what trustlines and account flags are active?","exampleUseCases":[{"title":"DeFi portfolio balance check","prompt":"Look up XRPL account rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe — I need the current XRP balance, how much is actually spendable, and the list of all trustlines including token balances."},{"title":"Compliance flag verification","prompt":"Check whether XRPL address rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh has deposit auth enabled and whether it requires a destination tag on incoming payments."},{"title":"Reserve and owner count audit","prompt":"For XRPL address r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59, what is the current reserve amount tied up, how many owner objects are on the account, and what ledger index was the snapshot taken at?"}],"resultDescription":"Returns a JSON object with ok status, XRPL network identifier, XRP balance, calculated spendable XRP (balance minus reserve), reserve XRP, owner count, ledger index, account flags (deposit_auth, require_dest_tag), trustlines array (each with currency, issuer, balance, frozen status), and a payment receipt including tx_hash and receipt_id.","failureModes":["Invalid r-address format returns validation error (pattern mismatch)","Account not found on XRPL mainnet returns found: false","Payment failure or insufficient USDC balance prevents call from completing","Network timeout if XRPL node is unreachable","Ledger data may be slightly stale if queried mid-ledger close"],"whenToPreferThis":"Use this endpoint when you need a comprehensive, single-call snapshot of an XRPL mainnet account including balance, reserves, spendable XRP, all trustlines, and account flags. Prefer it over raw XRPL node queries when you want a clean structured JSON response with no RPC boilerplate. Ideal for agents building XRPL portfolio dashboards, compliance checks, or payment pre-flight checks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T18:55:41.536Z","isFirstParty":false,"canonicalSlug":"xrpl-account-read-balance-reserve-spendable-trustlines-flags-d05073f8"}