# XLS-20 NFTs Held by an XRPL Account

> XLS-20 NFTs Held by an XRPL Account 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 all XLS-20 standard NFTs currently held by a given XRP Ledger account address.

## Facts

- Endpoint: POST https://twin.unykorn.org/xrpl-nfts?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/xls-20-nfts-held-by-an-xrpl-account-b32bc98f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JQhVlmH47W-p29ZLGLvu2

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 xls-20-nfts-held-by-an-xrpl-account-b32bc98f -d '<json body>'
```

Example prompt: Can you pull up all the XLS-20 NFTs held by XRPL account rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh and show me what they're holding?

## When to prefer this

Choose this endpoint when you specifically need XLS-20 standard NFT holdings for an XRPL account and are comfortable with x402 micropayment-gated access at $0.005 per call. It is part of the UnyKorn multi-chain operator network alongside Bitcoin and EVM utilities, making it a good fit if you are already using that provider for other blockchain lookups.

## Known failure modes

- Invalid XRPL address format (does not match r-address regex) — request rejected with validation error
- Account not found on the XRP Ledger — empty NFT list or 404-style error
- Payment failure (x402 micropayment not completed) — endpoint returns 402 Payment Required
- Network timeout reaching XRPL node — may return 5xx or timeout error
- Account holds no XLS-20 NFTs — returns ok:true with empty NFT array

## How this service works

XLS-20 NFTs held by an XRPL account — Genesis402 / UnyKorn Operator Network

## Output

Returns a JSON object confirming success (ok: true), the endpoint type ('xrpl-nfts'), a payment receipt containing the transaction hash, USD amount charged, and a unique receipt ID, plus a generated_at ISO8601 timestamp. The NFT data for the queried account is included in the response payload.

## 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-nfts",
  "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/xls-20-nfts-held-by-an-xrpl-account-b32bc98f/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)