{"openapi":"3.1.0","info":{"title":"XRP Ledger (XRPL) API","version":"1.0.0","description":"Live on-chain data from the XRP Ledger (XRPL), the decentralized blockchain behind XRP, served straight from public XRPL nodes by JSON-RPC — no key, nothing cached. The account endpoint returns any address's core state: its XRP balance, transaction sequence, the number of objects it owns, and its account flags and domain — the genesis-era account rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh holds tens of thousands of XRP. The balances endpoint returns the full wallet: the XRP balance plus every issued-currency trustline (token or stablecoin) the account holds, with the issuer, currency and amount, decoding hex currency codes to readable tickers. The transactions endpoint returns the account's most recent ledger activity — payments, DEX offers, trustline changes — each with its hash, type, amount, fee, result and time. The server endpoint returns the state of the ledger itself: the latest validated ledger index and age, the base and per-object XRP reserves, the current fee and the node software version — the network health a wallet or explorer needs. Everything is read live from the XRPL, nothing stored. This is the XRP Ledger on-chain layer for any wallet, explorer, exchange, payments or analytics app. Distinct from EVM and Solana on-chain APIs and from price feeds — this is XRPL account state, token balances, transactions and ledger health. 4 endpoints, no key on our side.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/xrpl-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/account":{"get":{"operationId":"get_v1_account","tags":["XRPL"],"summary":"An address's core state","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"XRPL classic address","schema":{"type":"string"},"example":"rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"flags":1703936,"source":"XRP Ledger","address":"rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh","sequence":44196,"balance_xrp":56760.625556,"owner_count":1,"ledger_index":104804932,"balance_drops":"56760625556"},"meta":{"timestamp":"2026-06-09T11:38:20.986Z","request_id":"33f5cceb-2890-42df-8bef-00858b0c3609"},"status":"ok","message":"Account 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/balances":{"get":{"operationId":"get_v1_balances","tags":["XRPL"],"summary":"XRP + token (trustline) balances","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"XRPL classic address","schema":{"type":"string"},"example":"rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"xrp":56760.625556,"source":"XRP Ledger","tokens":[{"limit":0,"issuer":"rwdFmXzRpUC6DCcPedKSLaBZQyyCdnu72m","balance":-0.1165139515638055,"currency":"USD","currency_raw":"USD"},{"limit":0,"issuer":"rD1jovjQeEpvaDwn9wKaYokkXXrqo4D23x","balance":-1,"currency":"USD","currency_raw":"USD"},{"limit":0,"issuer":"rDv5FHeAdRSsUpSa1mLyrZKhSoRXzotCvY","balance":-1,"currency":"USD","currency_raw":"USD"},{"limit":0,"issuer":"rUjbzuRoQagHet3XnygZkfaTFTFkMoD3YG","balance":-99999899,"currency":"USD","currency_raw":"USD"},{"limit":0,"issuer":"rUjbzuRoQagHet3XnygZkfaTFTFkMoD3YG","balance":-10000000,"currency":"CNY","currency_raw":"CNY"},{"limit":0,"issuer":"rfMwmKUJR53jbRratQVGmPJZLBZJiuKZ9a","balance":-900000000,"currency":"USD","currency_raw":"USD"},{"limit":0,"issuer":"r9BFYMX3uNRpVkNXKihN7NmF1eBJvsXk4W","balance":-900,"currency":"USD","currency_raw":"USD"}],"address":"rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh","token_count":7},"meta":{"timestamp":"2026-06-09T11:38:21.311Z","request_id":"10fae255-e368-47d4-97ce-288655ee5fa5"},"status":"ok","message":"Balances 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/server":{"get":{"operationId":"get_v1_server","tags":["XRPL"],"summary":"Live XRPL ledger state","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"peers":14,"source":"XRP Ledger","load_factor":1,"server_state":"full","build_version":"3.1.3","uptime_seconds":787102,"complete_ledgers":"32570-104804932","validated_ledger":{"index":104804932,"age_seconds":2,"base_fee_xrp":1.0e-5,"reserve_inc_xrp":0.2,"reserve_base_xrp":1}},"meta":{"timestamp":"2026-06-09T11:38:21.568Z","request_id":"7103fd3d-ebfa-44a8-9cee-8bdfccd46607"},"status":"ok","message":"Server info 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/transactions":{"get":{"operationId":"get_v1_transactions","tags":["XRPL"],"summary":"Recent account transactions","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"XRPL classic address","schema":{"type":"string"},"example":"rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh"},{"name":"limit","in":"query","required":false,"description":"Max transactions (1-100, default 20)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"source":"XRP Ledger","address":"rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh","transactions":[{"date":"2026-06-09T07:32:30.000Z","hash":"C04DF039D3C12870EB2663A79A6DA331316379CB1E4606455251A5F905984663","type":"Payment","amount":{"value":1.0e-6,"currency":"XRP"},"result":"tesSUCCESS","account":"rUDxJ3UgwoQpqg4JmYKWaQ86pMqbcyRoqn","fee_xrp":1.0e-5,"validated":true,"destination":"rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh","ledger_index":104801101},{"date":"2026-06-02T03:40:51.000Z","hash":"0337B1568468AA487E93F3A71C9D88FA2270E2A90BB816AAB9AB9DE4CFD448D1","type":"Payment","amount":{"value":1.0e-6,"currency":"XRP"},"result":"tesSUCCESS","account":"rhkPTtL7Rs3L4KMWubW4i1FPDm3yDy6E5V","fee_xrp":1.0e-5,"validated":true,"destination":"rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh","ledger_index":104641078},{"date":"2026-05-21T12:23:41.000Z","hash":"D7241E7A3EC25C632A0438264961535A9A1D4D951CA41CCEF3EBBBA16EC7ECF6","type":"Payment","amount":{"value":1.0e-6,"currency":"XRP"},"result":"tesSUCCESS","account":"rULevsm2SjGBUWNkiVBQwQsSpxrYnLcjB8","fee_xrp":1.0e-5,"validated":true,"destination":"rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh","ledger_index":104380769},{"date":"2026-05-21T12:19:01.000Z","hash":"A88F0271AC6DA4BBE77F2084430D0CA0A9C220D0A285A011B65091CE0CB206E6","type":"Payment","amount":{"value":1.0e-6,"currency":"XRP"},"result":"tesSUCCESS","account":"rULevsm2SjGBUWNkiVBQwQsSpxrYnLcjB8","fee_xrp":1.0e-5,"validated":true,"destination":"rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh","ledger_index":104380697},{"date":"2026-05-21T12:17:42.000Z","hash":"3CE3B3749C23DBB191759C5566BF2B50ADBD0AEC1B942F1BE76756CBF4270421","type":"Payment","amount":{"value":1.0e-6,"currency":"XRP"},"result":"tesSUCCESS","account":"rULevsm2SjGBUWNkiVBQwQsSpxrYnLcjB8","fee_xrp":1.0e-5,"validated":true,"destination":"rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh","ledger_index":104380677},{"date":"2026-05-18T13:17:22.000Z","hash":"C4B8C3DE68F860A3D9383F5361AA4B13479A0245552E1E1CB059C2E5AACFBEFE","type":"Payment","amount":{"value":0.0107,"currency":"XRP"},"result":"tesSUCCESS","account":"rPAG9xibmA9fowK5o8vgZsfE7MjHH5jw4M","fee_xrp":1.0e-5,"validated":true,"destination":"rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh","ledger_index":104314416},{"date":"2026-05-15T16:49:01.000Z","hash":"662EFE69853B92104883BE5E067869949F80CD7713A19F7A2EFFC8CE4DA34D81","type":"Payment","amount":{"value":0.0107,"currency":"XRP"},"result":"tesSUCCESS","account":"rPAG9xibmA9fowK5o8vgZsfE7MjHH5jw4M","fee_xrp":1.0e-5,"validated":true,"destination":"rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh","ledger_index":104250424},{"date":"2026-05-09T23:19:51.000Z","hash":"0C75C474FE6E14EB63E90FCD5E142B2C53AF18908AF8E7A94A7484DAFE9605F9","type":"Payment","amount":{"value":1.0e-6,"currency":"XRP"},"result":"tesSUCCESS","account":"rDRZCpJnETP5YfbmHcQjtjp3UpJ6Tzq9yu","fee_xrp":1.2e-5,"validated":true,"destination":"rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh","ledger_index":104122831},{"date":"2026-05-09T22:34:30.000Z","hash":"420F8CF612A09CBF54508BB0089AF9E97EF19E42F70546075450340F19D552B2","type":"AccountSet","result":"tesSUCCESS","account":"rf7Bvd12tKadaVP1SLyKSgaC8QitFH83fB","fee_xrp":1.2e-5,"validated":true,"ledger_index":104122128},{"date":"2026-05-09T22:33:12.000Z","hash":"26F8DE2482E9D3481A0B0E91539B3B8E58B69FD2B517B10C29270214C127298D","type":"SetRegularKey","result":"tesSUCCESS","account":"rf7Bvd12tKadaVP1SLyKSgaC8QitFH83fB","fee_xrp":1.2e-5,"validated":true,"ledger_index":104122109}]},"meta":{"timestamp":"2026-06-09T11:38:21.859Z","request_id":"789d5100-8a15-4e9d-8a78-ddf15f6da0c6"},"status":"ok","message":"Transactions 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":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Public XRP Ledger nodes via JSON-RPC (live)","service":"xrpl-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/server":"Live XRPL ledger state: validated ledger, reserves, fee, node version.","GET /v1/account":"An address's core state (address=rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh): XRP balance, sequence, flags.","GET /v1/balances":"An address's XRP + issued-token (trustline) balances (address=).","GET /v1/transactions":"An address's recent transactions (address=, limit)."},"description":"Live on-chain data from the XRP Ledger (XRPL) via public nodes: any address's core state (XRP balance, sequence, owner count, flags, domain); the full wallet of XRP plus every issued-currency trustline with issuer, currency and amount (hex currency codes decoded); the account's most recent transactions (payments, offers, trustline changes) with hash, type, amount, fee, result and time; and the live ledger state (latest validated ledger, close time, XRP reserves, fee, node version). Live, no key, nothing stored. Distinct from EVM and Solana on-chain APIs and from price feeds — this is XRPL account state, token balances, transactions and ledger health.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-09T11:38:22.108Z","request_id":"afab7ddd-f527-43eb-a6b0-1b8dcb4e0f7f"},"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":4000,"rps_limit":5,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1300,"monthly_call_quota":100000,"rps_limit":12,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3300,"monthly_call_quota":600000,"rps_limit":30,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":7900,"monthly_call_quota":3500000,"rps_limit":80,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/xrpl-api"}