{"uid":"cap_Bppz6cW73xDjyyXT0K-UR","slug":"stellar-account-read-balances-trustlines-signers-thresholds-flags-f0cffafc","name":"Stellar Account Read — Balances, Trustlines, Signers, Thresholds, Flags","description":"Stellar account read — balances, trustlines, signers, thresholds, flags — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/stellar-account?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"account":{"type":"string","pattern":"^G[A-Z2-7]{55}$"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"stellar-account","found":true,"network":"stellar:pubnet","receipt":{"tx_hash":"0x<64hex>","amount_usd":0.008,"receipt_id":"g402-<16hex>"},"signers":[{"key":"GBYL…JEPI","weight":1}],"balances":[{"asset":"USDC","issuer":"GA5Z…KZVN","balance":"0.3406290","authorized":true}],"thresholds":{"low_threshold":0,"med_threshold":0,"high_threshold":0},"home_domain":"usdf.unykorn.org","native_balance":"30.0459001"}},"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_Xjkljo_p8-anl5-s5bKf8","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 comprehensive on-chain state for a Stellar account including balances, trustlines, signers, thresholds, and flags from Stellar Pubnet","exampleAgentPrompt":"Can you look up the current balances, trustlines, and signers for Stellar account GBYL...JEPI on Pubnet?","exampleUseCases":[{"title":"Check DeFi wallet asset holdings","prompt":"What assets and balances does the Stellar account GDQP2KPQGKIHYJGXNUIYOMHARUARCA7DJT5FO2FFOOKY3B2WSQHG4W37 currently hold, including any USDC or other tokens?"},{"title":"Verify multisig signer configuration","prompt":"I need to check the signing weights and threshold settings on Stellar account GAJBJJJKMBC3MMTBDJFKRJDOEOVGFOMYP6FKVQRCNJM2THGQPZC4JKZR before I submit a high-value transaction — can you pull the full signer list?"},{"title":"Audit trustline authorization status","prompt":"Can you check whether Stellar address GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5 has an authorized trustline for the USDC issuer GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN?"}],"resultDescription":"Returns a JSON object with ok status, found flag, network identifier (stellar:pubnet), payment receipt details (tx_hash, amount_usd, receipt_id), array of signers with keys and weights, array of asset balances with asset code, issuer, balance amount, and authorization status, low/med/high signing thresholds, home domain, and native XLM balance as a string.","failureModes":["Account not found on Pubnet — returns found:false with ok:true","Invalid G-address format rejected at input validation","Payment failure or insufficient USDC balance causes 402 error","Stellar Horizon node unavailable causes timeout or 5xx error","Malformed account string not matching ^G[A-Z2-7]{55}$ pattern returns validation error"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive, single-call snapshot of a Stellar account's full on-chain state — balances, trustlines, signers, and thresholds — without running your own Horizon node. Ideal for agents that need to verify account configuration before constructing transactions, audit multisig setups, or check asset authorization status. Prefer over Horizon REST directly when operating in a pay-per-call x402 agent context where no persistent infrastructure is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T18:55:54.464Z","isFirstParty":false,"canonicalSlug":"stellar-account-read-balances-trustlines-signers-thresholds-flags-f0cffafc"}