{"uid":"cap_DvINOcKBe-YXvNTWyYyHv","slug":"xrpl-gateway-balances-lookup-9c9f1ea0","name":"XRPL Gateway Balances Lookup","description":"What an XRPL issuer actually has outstanding — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/xrpl-gateway-balances?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-gateway-balances","receipt":{"tx_hash":"0x<64hex>","amount_usd":0.005,"receipt_id":"g402-<16hex>"},"generated_at":"<iso8601>"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_69zjjXTCJJvCJk9WzVKED","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the outstanding issued token balances for a given XRPL issuer account (gateway balances)","exampleAgentPrompt":"Check what tokens and amounts are actually outstanding for XRPL issuer account rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh — I need to see the full gateway balances.","exampleUseCases":[{"title":"Audit an XRPL stablecoin issuer","prompt":"Can you pull the gateway balances for XRPL account rN7n3473SaZBCG4dFL83w7PB8sRCDYLQ5R? I want to know exactly how much of each token that issuer has outstanding right now."},{"title":"Monitor circulating supply of an XRPL token","prompt":"What's the total outstanding issued balance for the XRPL gateway at rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh? I'm tracking how much of their token is actually in circulation."},{"title":"Verify issuer obligations before a trade","prompt":"Before I buy this XRPL token, can you check the gateway balances for the issuer address r3ADD8kXSUKHd6zTCKfnKT3zV9XZHALqcs so I can see what they actually have outstanding?"}],"resultDescription":"Returns a JSON object with ok status, a type field of 'xrpl-gateway-balances', the outstanding issued token balances for the queried XRPL issuer account, and a receipt object containing the transaction hash, USD amount paid, and a receipt ID for the x402 micropayment.","failureModes":["Invalid XRPL account address format returns a validation error","Account not found on the XRP Ledger returns empty or error response","Account has no issued currencies returns empty balances","Network connectivity issues to XRPL nodes cause timeouts","Payment authorization failure blocks the request before processing","Non-issuer accounts (regular wallets) may return no gateway balance data"],"whenToPreferThis":"Use this endpoint when you need to know the precise outstanding token obligations of a specific XRPL issuer (gateway) — i.e., how much of each issued currency is held by counterparties. Prefer this over a general XRPL account read when the focus is on issued token liabilities rather than XRP balances, trustlines, or account flags. Ideal for DeFi audits, circulating supply checks, and due diligence on XRPL token issuers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T04:55:46.221Z","isFirstParty":false,"canonicalSlug":"xrpl-gateway-balances-lookup-9c9f1ea0"}