GET /tokens
GET

/v1/tokens

List all tokens with metrics

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/tokens?limit=5&sort=vol24hxrp
Query parameterValueDescription
limitint (max 100; default 100, or 50 with tag/filter/filterNe, 20 with sort=assessmentScore|pro5m|trendingScore)
offsetint (default 0)
sorttoken field name: vol24hxrp|marketcap|pro5m|pro1h|pro24h|pro7d|exch|holders|tvl|trendingScore|assessmentScore|dateon (unknown field = no-op)
orderasc|desc (default: desc)
tagfilter by tag (see /tags, case-insensitive)
filtertext search on token name
watchlistwatchlist owner account (r-address) — filters to that account's watchlist tokens
show_newbool - only tokens created in the last 7 days
show_slugbool - only tokens whose slug equals their md5
show_datebool - only tokens with missing/unknown date
tagsyes - include tags array
token_typetrustline|lp|mpt|xls14|demurrage|nonstandard (invalid value = no filter, echoed back as token_type: null)
skip_metricsbool - skip the global metrics envelope (exch/H24/global) — combine with lightweight for the smallest payload
lightweightbool - strip each token to ~50 essential fields (~77% smaller per token; see tokenFields)
filterNetext - exclude matching tokens (negative filter)
curl 'https://api.xrpl.to/v1/tokens?limit=5&sort=vol24hxrp'

Response

200Example response10 ms · just now · 9.9 KB · 331 lines
https://api.xrpl.to/v1/tokens?limit=5&sort=vol24hxrp
{
  "success": true,
  "took": 9,
  "total": 20391,
  "count": 5,
  "tagName": "",
  "start": 0,
  "limit": 5,
  "sortBy": "vol24hxrp",
  "sortType": "desc",
  "tokens": [
    {
      "_id": "0dd550278b74cb6690fdae351e8e0df3",
      "amount": "1036381637.0696695109",
      "supply": "1036381637.0696695109",
      "trustlines": 98086,
      "offers": 10136,
      "holders": 67329,
      "issuer": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
      "currency": "524C555344000000000000000000000000000000",
      "name": "RLUSD",
      "md5": "0dd550278b74cb6690fdae351e8e0df3",
      "slug": "rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De-524C555344000000000000000000000000000000",
      "ext": "png",
      "dateon": 1723248000000,
      "date": "2024-08-10",
      "kyc": true,
      "verified": 1,
      "hashicon": false,
      "exch": 0.6969044989734491,
      "time": 1789975930000,
      "usd": "1.000476098726283528",
      "assessmentScore": 0.33,
      "trendingScore": 0.66,
      "maxMin24h": [
        0.7279508085317149,
        0.691988533552646
      ],
      "dom": 84.6001,
      "id": 1,
      "marketcap": 722259025.527321,
      "p24h": -0.0270442723261086,
      "p7d": -0.0236136977136082,
      "pro24h": -3.7356610575581928,
      "pro7d": -3.2773214919739724,
      "holders24h": -12,
      "marketcap24h": -27113552.820890427,
      "trustlines24h": 68,
      "social": {
        "twitter": "ripple"
      },
      "tags": [
        "Stablecoin",
        "Ripple",
        "XRPL",
        "Trending",
        "United States"
      ],
      "user": "Ripple",
      "domain": "ripple.com",
      "whitepaper": "https://ripple.com/reports/rlusd-whitepaper.pdf",
      "p1h": -0.0021308776483045,
      "p5m": 0.0013758593115747
    },
    {
      "_id": "1c54f16ec1b45eef983f202b9954999b",
      "amount": "3997762.7657474759221",
      "supply": "3997762.7657474759221",
      "trustlines": 14287,
      "offers": 1309,
      "holders": 10355,
      "issuer": "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE",
      "currency": "5553444300000000000000000000000000000000",
      "name": "USDC",
      "md5": "1c54f16ec1b45eef983f202b9954999b",
      "slug": "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE-5553444300000000000000000000000000000000",
      "dateon": 1744730619450,
      "date": "2025-04-15",
      "kyc": true,
      "verified": 1,
      "hashicon": false,
      "tvl": 447378.528282,
      "assessmentScore": 0.56,
      "trendingScore": 6.15,
      "exch": 0.6968641114977329,
      "time": 1789975871000,
      "usd": "1.0023693379783390034",
      "AMM": "rM7cHVPfhe9yxQNk2kDNBEQqoQmMcQGPWE",
      "lastUpdated": "2026-09-21T07:31:13.758Z",
      "maxMin24h": [
        0.7577751334402036,
        0.6925869806941755
      ],
      "dom": 0.3263,
      "id": 2,
      "marketcap": 2785897.397731334,
      "p1h": -0.0026203000119633,
      "p24h": -0.0270410517487832,
      "p5m": 0.0017921715519485,
      "p7d": -0.0234300952441859,
      "pro1h": -0.3746044899425205,
      "pro24h": -3.7354412044129592,
      "pro5m": 0.2578397211788319,
      "pro7d": -3.2528507136224905,
      "vol24h": 420171.30123,
      "vol24hAMM": 45048.072255,
      "vol24htx": 1972,
      "vol24htxAMM": 835
    },
    {
      "_id": "cd9499746c1b2e041563a9724330b3e6",
      "amount": "588570904.89313374118",
      "supply": "588570904.89313374118",
      "trustlines": 22548,
      "offers": 600,
      "holders": 22003,
      "issuer": "rGG3wQ4kUzd7Jnmk1n5NWPZjjut62kCBfC",
      "currency": "41524D5900000000000000000000000000000000",
      "name": "ARMY",
      "md5": "cd9499746c1b2e041563a9724330b3e6",
      "slug": "rGG3wQ4kUzd7Jnmk1n5NWPZjjut62kCBfC-41524D5900000000000000000000000000000000",
      "ext": "webp",
      "dateon": 1731196800000,
      "date": "2024-11-10",
      "verified": false,
      "hashicon": false,
      "exch": 0.00588011873152561,
      "time": 1789975510000,
      "usd": "0.008473839104001556571",
      "assessmentScore": 0.27,
      "trendingScore": 60.82,
      "maxMin24h": [
        0.005895218756328812,
        0.005675418482929734
      ],
      "dom": 0.406,
      "id": 3,
      "marketcap": 3460866.802693094,
      "p24h": 0.000098936682902138,
      "p7d": 0.000677483280606022,
      "pro24h": 1.7113573326357434,
      "pro7d": 13.021924887823433,
      "holders24h": -4,
      "marketcap24h": 57994.807011319324,
      "trustlines24h": -2,
      "p1h": 0.00005637215457979,
      "p5m": 0,
      "pro1h": 0.96797059822189,
      "pro5m": 0,
      "domain": "xrparmy-cto.com",
      "origin": "FirstLedger",
      "social": {
        "twitter": "ARMY_XRP589",
        "telegram": "XRP_Army_CTO"
      },
      "user": "ARMY"
    },
    {
      "_id": "b05f7c8e58b832c74267d988567dea33",
      "amount": "320942470935.25062963",
      "supply": "320942470935.25062963",
      "trustlines": 11906,
      "offers": 460,
      "holders": 11063,
      "issuer": "rhCAT4hRdi2Y9puNdkpMzxrdKa5wkppR62",
      "currency": "46555A5A59000000000000000000000000000000",
      "name": "FUZZY",
      "md5": "b05f7c8e58b832c74267d988567dea33",
      "slug": "rhCAT4hRdi2Y9puNdkpMzxrdKa5wkppR62-46555A5A59000000000000000000000000000000",
      "ext": "webp",
      "dateon": 1737590400000,
      "date": "2025-01-23",
      "verified": 4,
      "hashicon": false,
      "exch": 0.00003153826406135454,
      "time": 1789975641000,
      "usd": "0.000045468715297254840318",
      "assessmentScore": 0.74,
      "trendingScore": 71.8,
      "maxMin24h": [
        0.00003260872657689114,
        0.00003104489380862917
      ],
      "dom": 1.1875,
      "id": 4,
      "marketcap": 10121968.396859538,
      "p24h": -9.9540101961351e-7,
      "p7d": -0.000003823828193064236,
      "pro24h": -3.0596030823339837,
      "pro7d": -10.81335393152938,
      "holders24h": 14,
      "marketcap24h": -466663.6719173975,
      "trustlines24h": 78,
      "p1h": -1.763231066197e-8,
      "p5m": 0,
      "pro1h": -0.0558764373355114,
      "pro5m": 0,
      "domain": "fuzzyxrp.com",
      "origin": "FirstLedger",
      "social": {
        "twitter": "fuzzy_xrp",
        "telegram": "fuzzyxrp"
      },
      "user": "Fuzzybear"
    },
    {
      "_id": "233d2c15a1c1288bb65b318ab1846e58",
      "amount": "989044.55762458931925",
      "supply": "989044.55762458931925",
      "trustlines": 12588,
      "offers": 462,
      "holders": 11464,
      "issuer": "rszenFJoDdiGjyezQc8pME9KWDQH43Tswh",
      "currency": "44524F5000000000000000000000000000000000",
      "name": "DROP",
      "md5": "233d2c15a1c1288bb65b318ab1846e58",
      "slug": "rszenFJoDdiGjyezQc8pME9KWDQH43Tswh-44524F5000000000000000000000000000000000",
      "ext": "webp",
      "dateon": 1729123200000,
      "date": "2024-10-17",
      "verified": false,
      "hashicon": false,
      "exch": 1.6418458662594895,
      "time": 1789975660000,
      "usd": "2.3670491853863060122",
      "assessmentScore": 0.44,
      "trendingScore": 64.26,
      "maxMin24h": [
        1.7057924250706857,
        1.5280662752258456
      ],
      "dom": 0.1905,
      "id": 5,
      "marketcap": 1623858.7184823775,
      "p24h": -0.0486297551224775,
      "p7d": 0.055669055619169,
      "pro24h": -2.8766907080696402,
      "pro7d": 3.5096374657435536,
      "holders24h": 5,
      "marketcap24h": -64288.713554698275,
      "trustlines24h": 2,
      "p1h": 0.0209242481226331,
      "p5m": 0,
      "pro1h": 1.2908858694033576,
      "pro5m": 0,
      "domain": "xrp-drop.com",
      "origin": "FirstLedger",
      "social": {
        "twitter": "drop_xrp",
        "telegram": "dropxrpl",
        "instagram": "drop_xrp",
        "tiktok": "drop_xrp",
        "youtube": "dropxrpl"
      },
      "user": "DROP"
    }
  ],
  "exch": {
    "USD": 0.6952169076751947,
    "EUR": 0.798178531701891,
    "JPY": 0.004419461245690763,
    "CNY": 0.10384586429193163
  },
  "H24": {
    "_id": "METRICS_24H",
    "activeAddresses24H": 17534,
    "tradedTokens24H": 1302,
    "tradedXRP24H": 5727793.322185,
    "transactions24H": 104981,
    "lastUpdated": "2026-09-21T07:31:54.315Z",
    "updateStatus": "complete",
    "uniqueTraders24H": 6153,
    "xrpPro24h": 3.9681966028189297,
    "totalTVLPro": -0.4473963376000256,
    "globalBuy24hAMM": 296366.3912630001,
    "globalBuy24hOrderbook": 2462169.4546459983,
    "globalBuy24htx": 59181,
    "globalBuy24hxrp": 2758535.8459089985,
    "globalSell24hAMM": 352868.5455080006,
    "globalSell24hOrderbook": 2616391.4364749985,
    "globalSell24htx": 45803,
    "globalSell24hxrp": 2969259.9819829958,
    "globalVol24hAMM": 649234.9367710007,
    "globalVol24hOrderbook": 5078560.891121001,
    "globalDeposit24htx": 425,
    "globalDeposit24hxrp": 6500.6809969999995,
    "globalWithdraw24htx": 106,
    "globalWithdraw24hxrp": 4499.06935,
    "transactions24HPro": 22.415141013523755,
    "globalTrades24hAMM": 68599,
    "globalTrades24hOrderbook": 36385,
    "uniqueTraders24hAMM": 5503,
    "uniqueTraders24hOrderbook": 1579,
    "globalAmmCreate24htx": 3,
    "globalAmmCreate24hxrp": 550.038
  },
  "global": {
    "_id": "METRICS_GLOBAL",
    "gDexVolume": 5715129.309568,
    "gDexVolumePro": -7.057739656870698,
    "gMarketcap": 852387025.6131839,
    "gMarketcapPro": -3.355684653971003,
    "gNFTIOUVolume": 0,
    "gNFTIOUVolumePro": 0,
    "gScamVolume": 9152.602349,
    "gScamVolumePro": 0.16014689875305438,
    "gStableVolume": 5180047.282589001,
    "gStableVolumePro": 90.63744671387941,
    "gXRPdominance": 98.64334887664619,
    "gXRPdominancePro": 0.026982952025211837,
    "gMemeVolume": 312724.584365,
    "gMemeVolumePro": 5.471872418379952,
    "sentimentScore": 51,
    "totalAddresses": 8350000,
    "totalOffers": 182773,
    "totalTrustLines": 6886671,
    "avgRSI15m": 47.06,
    "avgRSI1h": 45.74,
    "avgRSI24h": 45.2,
    "avgRSI4h": 43.35,
    "avgRSI7d": 45.19,
    "avgRSI": 44.91,
    "avgRSI30d": 49.54,
    "avgRSI90d": 47.62,
    "totalTVL": 23916853.31731786,
    "gUniqueTraders": 6153,
    "gUniqueTradersPro": -1.1407455012853451,
    "lastUpdated": "2026-09-21T07:31:06.015Z",
    "gTransactions24HPro": 22.415141013523755
  }
}

Long arrays and strings are shortened in the example; Send request for the full answer.

Shapeas documented
{
  success,
  took (ms),
  total (tokens matching the query,
  pre-pagination),
  count (tokens in this response),
  start,
  limit,
  tagName,
  sortBy,
  sortType,
  tokens[],
  exch,
  H24,
  global (metrics omitted when skip_metrics=true)
}

What it does

List all tokens with metrics

Each token comes back with its md5, the id every Token endpoint takes. Go to Token →
OpenAPI