# XRPL Gateway Balances Lookup

> XRPL Gateway Balances Lookup is a paid API for AI agents from twin.unykorn.org, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-02).

Returns the outstanding issued token balances for a given XRPL issuer account (gateway balances)

## Facts

- Endpoint: POST https://twin.unykorn.org/xrpl-gateway-balances?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/xrpl-gateway-balances-lookup-9c9f1ea0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DvINOcKBe-YXvNTWyYyHv

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 xrpl-gateway-balances-lookup-9c9f1ea0 -d '<json body>'
```

Example prompt: Check what tokens and amounts are actually outstanding for XRPL issuer account rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh — I need to see the full gateway balances.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

What an XRPL issuer actually has outstanding — Genesis402 / UnyKorn Operator Network

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object",
   "properties": {
    "account": {
     "type": "string",
     "pattern": "^r[1-9A-HJ-NP-Za-km-z]{24,34}$"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/xrpl-gateway-balances-lookup-9c9f1ea0/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)