{"openapi":"3.1.0","info":{"title":"XRPL Token API","version":"1.0.0","description":"Read live XRP Ledger token data from public XRPL nodes — no key — focused on the parts that account-balance APIs miss: what an issuer has actually issued, the native DEX, and native AMM pools. The issuer endpoint returns a gateway's obligations — the total amount of each currency it has issued into circulation, effectively each token's supply. The order-book endpoint returns the live XRPL decentralized-exchange book for any currency pair (against XRP or another issued token) with the best quality offers. And the AMM endpoint returns the on-chain Automated Market Maker pool for a pair — its two reserves, trading fee and LP token outstanding. Distinct from account-, balance- and transaction-level APIs: this is the token-issuance and on-chain-market layer for XRPL wallets, gateways, stablecoin issuers, market makers and analytics. Live from the ledger; short cache only.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/xrpltoken-api","description":"oanor gateway"}],"tags":[{"name":"XRPL"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/amm":{"get":{"operationId":"get_v1_amm","tags":["XRPL"],"summary":"Native AMM pool for a pair (reserves, fee, LP token)","description":"","parameters":[{"name":"asset","in":"query","required":true,"description":"First asset currency (XRP or code)","schema":{"type":"string"},"example":"XRP"},{"name":"asset2","in":"query","required":true,"description":"Second asset currency (e.g. USD)","schema":{"type":"string"},"example":"USD"},{"name":"asset2_issuer","in":"query","required":false,"description":"Second asset issuer (for issued tokens)","schema":{"type":"string"},"example":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B"},{"name":"asset_issuer","in":"query","required":false,"description":"First asset issuer (if issued token)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"On-chain XRPL Automated Market Maker pool for the pair: its two reserves (amount/amount2), LP token outstanding and trading fee. trading_fee is in units of 1/100000 (trading_fee_pct is the percentage).","asset":{"currency":"XRP"},"amount":"3903443325","asset2":{"issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B","currency":"USD"},"source":"public XRPL JSON-RPC (amm_info)","account":"rHUpaqUPbwzKZdzQ8ZQCme18FrgW9pB4am","amount2":{"value":"4466.834526319855","issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B","currency":"USD"},"lp_token":{"value":"3340531.752567071","issuer":"rHUpaqUPbwzKZdzQ8ZQCme18FrgW9pB4am","currency":"03930D02208264E2E40EC1B0C09E4DB96EE197B1"},"trading_fee":219,"trading_fee_pct":0.219},"meta":{"timestamp":"2026-06-14T08:04:00.462Z","request_id":"c42c8449-978a-4f46-8467-bf4e26b42a2b"},"status":"ok","message":"AMM pool retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/issuer":{"get":{"operationId":"get_v1_issuer","tags":["XRPL"],"summary":"An issuer's obligations — issued supply per currency","description":"","parameters":[{"name":"account","in":"query","required":true,"description":"XRPL issuer/gateway account (r...)","schema":{"type":"string"},"example":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Obligations of the issuer: for each currency, the total amount it has issued into circulation — effectively the token's supply. Sorted by amount.","issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B","source":"public XRPL JSON-RPC (gateway_balances)","tokens":[{"issued":"8387794.672870027","currency":"USD"},{"issued":"4960395.578424789","currency":"EUR"},{"issued":"898766.9732126573","currency":"JPY"},{"issued":"8999.899901060894","currency":"CHF"},{"issued":"8692.124775162521","currency":"AUD"},{"issued":"2358.979490177198","currency":"GBP"},{"issued":"389.7290413769974","currency":"ETH"},{"issued":"326.0626268684788","currency":"BTC"}],"token_count":8,"frozen_balances":{"rEDtyWDqWs9q1aZY82bjoetpADy7iviqhz":[{"value":"12.31459690692563","currency":"BTC"}]}},"meta":{"timestamp":"2026-06-14T08:04:01.324Z","request_id":"b2ce5e17-e88e-41de-bd2f-ce202c693ed4"},"status":"ok","message":"Issuer obligations retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/orderbook":{"get":{"operationId":"get_v1_orderbook","tags":["XRPL"],"summary":"Native DEX order book for a pair","description":"","parameters":[{"name":"base","in":"query","required":true,"description":"Base currency (XRP or 3-char code)","schema":{"type":"string"},"example":"XRP"},{"name":"quote","in":"query","required":true,"description":"Quote currency (e.g. USD)","schema":{"type":"string"},"example":"USD"},{"name":"quote_issuer","in":"query","required":false,"description":"Quote issuer (required for issued tokens)","schema":{"type":"string"},"example":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B"},{"name":"base_issuer","in":"query","required":false,"description":"Base issuer (required if base is an issued token)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":{"currency":"XRP"},"note":"Live XRPL decentralized-exchange order book: offers selling the base asset for the quote asset. quality is the exchange rate (taker_pays per taker_gets).","count":10,"quote":{"issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B","currency":"USD"},"offers":[{"account":"rPk3mNveiJzNXzxn9xkP2BhyQGUEtBAE3S","quality":1.1525e-6,"taker_gets":"2024724","taker_pays":{"value":"2.333494240408986","issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B","currency":"USD"}},{"account":"rPk3mNveiJzNXzxn9xkP2BhyQGUEtBAE3S","quality":1.1616e-6,"taker_gets":"2630655","taker_pays":{"value":"3.055768848","issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B","currency":"USD"}},{"account":"rBTwLga3i2gz3doX6Gva3MgEV8ZCD8jjah","quality":1.1661344e-6,"taker_gets":"239970000000","taker_pays":{"value":"279837.271968","issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B","currency":"USD"}},{"account":"r3rhWeE31Jt5sWmi4QiGLMZnY3ENgqw96W","quality":1.166135340700341e-6,"taker_gets":"62595129879","taker_pays":{"value":"72994.39310762974","issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B","currency":"USD"}},{"account":"r3rhWeE31Jt5sWmi4QiGLMZnY3ENgqw96W","quality":1.173300392002475e-6,"taker_gets":"87714045445","taker_pays":{"value":"102914.9239047414","issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B","currency":"USD"}},{"account":"rPk3mNveiJzNXzxn9xkP2BhyQGUEtBAE3S","quality":1.1747e-6,"taker_gets":"5000000","taker_pays":{"value":"5.8735","issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B","currency":"USD"}},{"account":"rNmp1eKUcH6fhENA286G6FEe1AEvpzDb9B","quality":1.1777e-6,"taker_gets":"1782213","taker_pays":{"value":"2.0989122501","issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B","currency":"USD"}},{"account":"r3PNP6H7UsUw2YqJzyC7WkWJarAZg5FYKB","quality":1.18e-6,"taker_gets":"91087898","taker_pays":{"value":"107.4837186072565","issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B","currency":"USD"}},{"account":"rPk3mNveiJzNXzxn9xkP2BhyQGUEtBAE3S","quality":1.1838e-6,"taker_gets":"3000000","taker_pays":{"value":"3.5514","issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B","currency":"USD"}},{"account":"rNmp1eKUcH6fhENA286G6FEe1AEvpzDb9B","quality":1.1888e-6,"taker_gets":"5000000","taker_pays":{"value":"5.944","issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B","currency":"USD"}}],"source":"public XRPL JSON-RPC (book_offers)","best_quality":1.1525e-6},"meta":{"timestamp":"2026-06-14T08:04:01.533Z","request_id":"7212128a-6838-4fe7-9591-fbf9313f8d0c"},"status":"ok","message":"Order book retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata & live sample","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sample":{"issuer_tokens":8},"source":"public XRPL JSON-RPC nodes (gateway_balances / book_offers / amm_info), keyless","service":"xrpltoken-api","endpoints":{"GET /v1/amm":"Native AMM pool for a pair (asset, asset_issuer, asset2, asset2_issuer).","GET /v1/meta":"This document.","GET /v1/issuer":"An issuer's obligations — issued supply per currency (account=r...).","GET /v1/orderbook":"Native DEX order book for a pair (base, base_issuer, quote, quote_issuer; XRP needs no issuer)."},"description":"Read live XRP Ledger token data from public XRPL nodes: an issuer's obligations (per-currency issued supply), the native DEX order book for any pair, and native AMM pools (reserves, fee, LP token). The token-issuance and on-chain-market layer for XRPL wallets, gateways and market makers. Distinct from account/balance/transaction APIs. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T08:04:01.620Z","request_id":"0b4769b9-d200-4c55-be30-5f18e853e6d5"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":5500,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1130,"monthly_call_quota":116000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3850,"monthly_call_quota":728000,"rps_limit":20,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":11100,"monthly_call_quota":4620000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/xrpltoken-api"}