# XRPL Order Book for Currency Pair

> XRPL Order Book for Currency Pair is a paid API for AI agents from twin.unykorn.org, paid per call via x402, $0.006/call, status unknown (last checked 2026-09-29).

Retrieves the current order book (bids and asks) on the XRP Ledger for a specified currency pair defined by base and quote currencies and their issuers.

## Facts

- Endpoint: POST https://twin.unykorn.org/xrpl-book?utm_source=zero.xyz
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/xrpl-order-book-for-currency-pair-c322cf1b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xYLvO_iqk0ghGdYPqzrFr

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-order-book-for-currency-pair-c322cf1b -d '<json body>'
```

Example prompt: Pull the current order book on the XRP Ledger for the SOLO/XRP pair — base currency SOLO issued by rHZwvHEs56GCmHupwjA4RY7oPA3EoAJWuZ and quote currency XRP with no issuer needed.

## When to prefer this

Use this endpoint when you need real-time order book data specifically from the XRP Ledger decentralized exchange (XRPL DEX), including issued currency pairs with specific issuers. Prefer this over general crypto market data APIs when you need on-chain XRPL order depth rather than centralized exchange prices.

## Known failure modes

- Invalid or unknown issuer address returns an error or empty order book
- Malformed currency code causes a bad request response
- Non-existent currency pair returns an empty order book with no bids or asks
- Network issues with the XRP Ledger node may result in timeout or stale data
- Missing required fields like baseCurrency or quoteCurrency will cause a validation error

## How this service works

XRPL order book for a currency pair — Genesis402 / UnyKorn Operator Network

## Output

Returns a JSON object with ok status, a type field identifying the response as 'xrpl-book', the full XRPL order book data for the requested currency pair (bids and asks), a payment receipt with transaction hash and amount paid, and a generated_at ISO8601 timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object",
   "properties": {
    "baseIssuer": {
     "type": "string"
    },
    "quoteIssuer": {
     "type": "string"
    },
    "baseCurrency": {
     "type": "string"
    },
    "quoteCurrency": {
     "type": "string"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "type": "xrpl-book",
  "receipt": {
   "tx_hash": "0x<64hex>",
   "amount_usd": 0.25,
   "receipt_id": "g402-<16hex>"
  },
  "generated_at": "<iso8601>"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/xrpl-order-book-for-currency-pair-c322cf1b/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)