{"uid":"cap_xYLvO_iqk0ghGdYPqzrFr","slug":"xrpl-order-book-for-currency-pair-c322cf1b","name":"XRPL Order Book for Currency Pair","description":"XRPL order book for a currency pair — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/xrpl-book?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"baseIssuer":{"type":"string"},"quoteIssuer":{"type":"string"},"baseCurrency":{"type":"string"},"quoteCurrency":{"type":"string"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"xrpl-book","receipt":{"tx_hash":"0x<64hex>","amount_usd":0.006,"receipt_id":"g402-<16hex>"},"generated_at":"<iso8601>"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uCw3LqBMHQkX1eLb8eBlV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Check XRPL DEX liquidity for arbitrage","prompt":"Show me the current order book on the XRP Ledger for the USDC/XRP pair — base currency USDC issued by rcEGREd8NmkKRE8GE424scsH1KDWN56Qme and quote currency XRP — I want to see how deep the bids and asks are."},{"title":"Monitor token price on XRPL DEX","prompt":"What's the best ask and bid right now on the XRP Ledger DEX for the SOLO token issued by rHZwvHEs56GCmHupwjA4RY7oPA3EoAJWuZ against XRP?"},{"title":"Research XRPL issued asset trading pairs","prompt":"Fetch the order book on the XRP Ledger for the token GateHub USD issued by rhub8VRN55s94qWKDv6jmDy1pUykJzF3wq paired against XRP so I can see what people are currently willing to buy and sell at."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T18:55:24.240Z","isFirstParty":false,"canonicalSlug":"xrpl-order-book-for-currency-pair-c322cf1b"}