XRPL API Guide - Free Token, Price & DEX Data API
There are two ways to read the XRP Ledger: ask the ledger itself, through its own commands, or ask an index that has already read every ledger and kept prices, trades and history. xrpl.to’s API does both, in 339 endpoints, free to start and with no key.
Two ways to read the XRP Ledger
| The ledger’s own commands | An index (a data API) | |
|---|---|---|
| Answers | What is true now: a balance, trust lines, open offers, one transaction | What happened over time: prices, candles, trades, rankings, search |
| Examples | account_info, account_lines, book_offers, tx | /tokens, /ohlc, /holders, /search |
| History | Recent ledgers on most servers; full history on a few | Kept and indexed, so a year of candles is one request |
| Where | Any XRP Ledger server, or POST /v1/rpc on xrpl.to | https://api.xrpl.to/v1 |
A first request
The two tokens with the most trading in the last 24 hours. No key, no sign-up:
curl "https://api.xrpl.to/v1/tokens?sort=vol24hxrp&order=desc&limit=2"
{
"success": true,
"total": 20468,
"tokens": [
{
"name": "RLUSD",
"issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
"currency": "524C555344000000000000000000000000000000",
"exch": 0.762471760532176,
"usd": "0.99909343433692883896",
"vol24hxrp": 3092792.208121,
"holders": 67589,
"md5": "0dd550278b74cb6690fdae351e8e0df3"
},
{
"name": "USDC",
"issuer": "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE",
"currency": "5553444300000000000000000000000000000000",
"exch": 0.7625438462711606,
"usd": "0.9991878908037212248",
"vol24hxrp": 312374.708854,
"holders": 10399,
"md5": "1c54f16ec1b45eef983f202b9954999b"
}
]
}&splits the command.The ledger’s own commands, through the same API
POST /v1/rpc passes the XRP Ledger’s read commands to a full node and returns its answer unchanged, so one base URL covers both kinds of question. Here, the first account ever created on the ledger:
curl -X POST "https://api.xrpl.to/v1/rpc" \
-H "Content-Type: application/json" \
-d '{"method":"account_info","params":{"account":"rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh","ledger_index":"validated"}}'{
"success": true,
"method": "account_info",
"result": {
"account_data": {
"Account": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
"Balance": "56785837001",
"Sequence": 44196,
"OwnerCount": 1
},
"ledger_index": 107755289,
"validated": true
}
}POST /v1/submit.What it covers
Live updates come over a WebSocket at wss://api.xrpl.to/ws/sync/; the WebSocket guide shows how to subscribe.
Limits and plans
Without a key: 2 req/sec burst, 30 req/min, 333/day (no key) + 0.25x endpoint windows, counted per IP address.
| Plan | Price | Credits a month | Requests a day | Requests a second |
|---|---|---|---|---|
| Free | Free | 1M | 33K | 10 (bursts of 20) |
| Developer | $49 for 30 days · $490 a year | 10M | 400K | 50 (bursts of 100) |
| Business | $499 for 30 days · $4,990 a year | 100M | 4M | 200 (bursts of 300) |
| Professional | $999 for 30 days · $9,990 a year | 200M | 8M | 500 (bursts of 750) |
Four independent layers apply to every request; the strictest one wins. All 429 responses carry Retry-After plus X-RateLimit-Limit/-Remaining/-Reset headers and a JSON body with retryAfter.
The one condition: credit xrpl.to
Any app, website, bot, or dashboard that displays xrpl.to data must show a visible, clickable credit to xrpl.to on the same screen as that data — not buried in an about page. The credit can read Data by xrpl.to, linked to https://xrpl.to.
Storing our data and re-serving it from your own API, dataset, or public dashboard requires written permission first. Email hello@xrpl.to — the answer is usually yes, we just need to know who is doing it.
Questions
- Is there a free XRP Ledger API?
- Yes. The XRP Ledger’s own public servers answer its commands for free, and xrpl.to’s API serves prices, trades, pools, NFTs and holders free to start, with no key: 2 req/sec burst, 30 req/min, 333/day (no key) + 0.25x endpoint windows. A free key raises the limits.
- Is there an alternative to Ripple’s Data API?
- Yes. xrpl.to’s API serves what most people used Ripple’s Data API v2 for: token prices and candles, trades, account history and exchange rates, plus pools, NFTs and holder rankings.
- Do I need an API key?
- Not to start. Without a key: 2 req/sec burst, 30 req/min, 333/day (no key) + 0.25x endpoint windows. A free key gives 10 requests a second and 1M credits a month.