# XRPL Account Lookup

> XRPL Account Lookup is a paid API for AI agents from cocoeatsai.com, paid per call via x402, $0.0014/call, status unknown (last checked 2026-10-19).

Checks whether an XRP Ledger account address exists and returns its XRP balance

## Facts

- Endpoint: GET https://cocoeatsai.com/area4/agent/xrpl/account?utm_source=zero.xyz
- Price: $0.0014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/xrpl-account-lookup-0e591035
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cecWTz1CXTqNs7ZQKlY-g

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-account-lookup-0e591035
```

Example prompt: Can you check if the XRP Ledger account rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh exists and tell me its current XRP balance?

## When to prefer this

Use this endpoint when you need a quick, cheap check on whether a specific XRPL account address is active and funded. It is ideal for pre-validating recipient wallets before initiating XRP transfers, auditing account existence for research, or enriching XRP address data in automated pipelines. Prefer it over full blockchain node queries when you only need existence and balance — not full transaction history.

## Known failure modes

- Invalid or malformed address (exceeds 40 characters or not a valid XRPL address format) — likely returns an error or exists: false
- Account does not exist on the ledger — returns {"exists": false} with no balance field
- Network or upstream XRPL node unavailability — may return a 5xx error
- Payment authorization failure (x402) — request rejected if USDC payment is not properly attached

## How this service works

Zach Riehn's lab: an about-me and portfolio, a news desk, The Atelier for AI experiments, Launch Lab for XRP research, and Fracture for games.

## Output

A JSON object indicating whether the given XRPL account address exists (boolean 'exists' field), and if it does, the current XRP balance as a numeric value (e.g. {"exists": true, "xrp_balance": 1}).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input",
  "output"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ]
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "title": "Address",
       "maxLength": 40
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type",
    "example"
   ],
   "properties": {
    "type": {
     "const": "json"
    },
    "example": {
     "type": "object",
     "required": [
      "exists"
     ],
     "properties": {
      "exists": {
       "type": "boolean"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "exists": true,
  "xrp_balance": 1
 },
 "exampleNote": "Illustrative response subset; not a live observation."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/xrpl-account-lookup-0e591035/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cocoeatsai.com](https://www.zero.xyz/host/cocoeatsai.com/llms.txt)