A valid request URL is required to generate request examples{
"exists": true,
"hasUsdcTrustline": true,
"xlmBalance": "<string>",
"usdcBalance": "<string>"
}{
"error": "<string>",
"message": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"details": {}
}Get classic account state
Returns on-chain state for a classic Stellar G-address: whether it exists, whether it has a USDC trustline, and its XLM and USDC balances. Used by the SDK to gate the onboarding flow and to display account state in UI.
A valid request URL is required to generate request examples{
"exists": true,
"hasUsdcTrustline": true,
"xlmBalance": "<string>",
"usdcBalance": "<string>"
}{
"error": "<string>",
"message": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"details": {}
}Authorizations
Server-held API key. Injected by the BFF (createRelayRoute / createSignerProxyRoute from @buckspay/nextjs). This key must only appear in server-side code and must never be shipped to a browser bundle.
Path Parameters
Stellar classic public key (G-address, StrKey encoded).
^G[A-Z2-7]{55}$"GABC1234..."
Query Parameters
Network to query. Stellar network identifier used in facilitator requests.
stellar-testnet, stellar-pubnet Response
Account state returned.
On-chain account state returned by the /stellar/account/:pk and /stellar/contract/:address endpoints. The SDK adapter normalizes the facilitator's nativeBalance field to xlmBalance and strips null values.
Whether the account exists on-chain.
Whether the account has an active USDC trustline.
Native XLM balance as a decimal string (e.g. 10.5000000). Omitted if the facilitator returned null or the account does not exist.
USDC balance as a decimal string. Omitted if the account has no trustline or the facilitator returned null.