Query Every Token on the XRP Ledger With One Endpoint

#javascriptapicryptotutorial

The XRP Ledger currently has 20,263 issued tokens, and 1,754 of them traded in the last 24 hours. Getting at that data usually means running your own rippled node or stitching together several exchange APIs.

There is a simpler path. Here is the whole thing in one fetch.

The endpoint

const res = await fetch(
  'https://api.xrpl.to/v1/tokens?limit=5&sortBy=vol24hxrp&sortType=desc'
);
const { tokens, total } = await res.json();

console.log(total);                    // 20,263
for (const t of tokens) {
  console.log(t.name, t.vol24hxrp, t.holders);
}

No API key, no signup. Output right now looks like this:

Token	24h volume (XRP)	Holders
RLUSD	5.79M	69,168
USDC	645.6K	10,283
FUZZY	34.4K	10,911
BTC	31.1K	4,368
PHNIX	24.7K	29,032

Useful query parameters

sortBy — vol24hxrp, marketcap, holders, trustlines
sortType — asc or desc
start and limit — pagination over all 20,263 tokens
tagName — filter to a category such as stablecoins or memes

Ledger-wide stats

A second endpoint gives you the 24-hour aggregates:

const { H24, exch, total } = await (
  await fetch('https://api.xrpl.to/v1/stats')
).json();

console.log('tokens traded:', H24.tradedTokens24H);   // 1,754
console.log('trades:', H24.transactions24H);          // 153,000
console.log('unique traders:', H24.uniqueTraders24H); // 6,677
console.log('XRP per USD:', exch.USD);

Note that exch.USD is XRP per USD, not the other way round. To get the XRP price in dollars, invert it:

const xrpUsd = 1 / exch.USD;   // ≈ 1.4669

That inversion catches almost everyone the first time.

Fields worth knowing

vol24hxrp — 24h volume denominated in XRP, not USD
marketcap — also denominated in XRP
holders vs trustlines — the gap tells you how many accounts opened a line and then emptied it
uniqueTraders24h — the cheapest wash-trading filter you will find
pro24h — 24h percentage change

One gotcha

Token names are not unique. Multiple issuers can publish under the same ticker — there are two different tokens called USDC on the ledger right now. Always key on the issuer field, or on md5, rather than on name:

const byIssuer = new Map(tokens.map(t => [`${t.issuer}:${t.currency}`, t]));

Rate limits are real but generous. Back off on a 429 and you will be fine:

async function get(url, attempt = 1) {
  const r = await fetch(url);
  if (r.ok) return r.json();
  if (r.status === 429 && attempt < 4) {
    await new Promise(s => setTimeout(s, attempt * 4000));
    return get(url, attempt + 1);
  }
  throw new Error(`HTTP ${r.status}`);
}

Live prices, holder counts, trustlines and order-book depth for every XRPL token are at xrpl.to.

DEV Community