# Stellar Account Read — Balances, Trustlines, Signers, Thresholds, Flags

> Stellar Account Read — Balances, Trustlines, Signers, Thresholds, Flags is a paid API for AI agents from twin.unykorn.org, paid per call via x402, $0.008/call, status unknown (last checked 2026-10-01).

Fetches comprehensive on-chain state for a Stellar account including balances, trustlines, signers, thresholds, and flags from Stellar Pubnet

## Facts

- Endpoint: POST https://twin.unykorn.org/stellar-account?utm_source=zero.xyz
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stellar-account-read-balances-trustlines-signers-thresholds-flags-f0cffafc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Bppz6cW73xDjyyXT0K-UR

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability stellar-account-read-balances-trustlines-signers-thresholds-flags-f0cffafc -d '<json body>'
```

Example prompt: Can you look up the current balances, trustlines, and signers for Stellar account GBYL...JEPI on Pubnet?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Stellar account read — balances, trustlines, signers, thresholds, flags — Genesis402 / UnyKorn Operator Network

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object",
   "properties": {
    "account": {
     "type": "string",
     "pattern": "^G[A-Z2-7]{55}$"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stellar-account-read-balances-trustlines-signers-thresholds-flags-f0cffafc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twin.unykorn.org](https://www.zero.xyz/host/twin.unykorn.org/llms.txt)