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 response1 ms · just now · 9.8 KB · 328 lines
https://api.xrpl.to/v1/tokens?limit=5&sort=vol24hxrp
{
  "success": true,
  "took": 0,
  "total": 20468,
  "count": 5,
  "tagName": "",
  "start": 0,
  "limit": 5,
  "sortBy": "vol24hxrp",
  "sortType": "desc",
  "tokens": [
    {
      "_id": "0dd550278b74cb6690fdae351e8e0df3",
      "amount": "1020243421.8616456357",
      "supply": "1020243421.8616456357",
      "trustlines": 100271,
      "offers": 10652,
      "holders": 67589,
      "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.7643751509638569,
      "time": 1792387600000,
      "usd": "1.0011152920632481522",
      "assessmentScore": 0.24,
      "trendingScore": 0.85,
      "maxMin24h": [
        0.8,
        0.7605383609832679
      ],
      "dom": 84.5463,
      "id": 1,
      "marketcap": 779848719.6053773,
      "p24h": -0.0095228271876065,
      "p7d": 0.0547333504400581,
      "pro24h": -1.2305016237867505,
      "pro7d": 7.712813760358883,
      "holders24h": 21,
      "marketcap24h": -15520257.927615881,
      "trustlines24h": 72,
      "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.0023310395042963,
      "p5m": 0.0003282482357406
    },
    {
      "_id": "1c54f16ec1b45eef983f202b9954999b",
      "amount": "4908747.528903191796",
      "supply": "4908747.528903191796",
      "trustlines": 14763,
      "offers": 1274,
      "holders": 10399,
      "issuer": "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE",
      "currency": "5553444300000000000000000000000000000000",
      "name": "USDC",
      "md5": "1c54f16ec1b45eef983f202b9954999b",
      "slug": "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE-5553444300000000000000000000000000000000",
      "dateon": 1744730619450,
      "date": "2025-04-15",
      "kyc": true,
      "verified": 1,
      "hashicon": false,
      "tvl": 207194.142902,
      "assessmentScore": 0.47,
      "trendingScore": 4.87,
      "exch": 0.7638117991406298,
      "time": 1792387201000,
      "usd": "1.0003643133344827727",
      "AMM": "rM7cHVPfhe9yxQNk2kDNBEQqoQmMcQGPWE",
      "lastUpdated": "2026-10-19T05:26:11.471Z",
      "maxMin24h": [
        0.7972972972972973,
        0.7605655387440469
      ],
      "dom": 0.4065,
      "id": 2,
      "marketcap": 3749359.2815786675,
      "p1h": 0.0014992391119304,
      "p24h": -0.0102777714811747,
      "p5m": 0,
      "p7d": 0.0542900168219126,
      "pro1h": 0.19666986883621895,
      "pro24h": -1.3277238024171911,
      "pro5m": 0,
      "pro7d": 7.65163497088035,
      "vol24h": 311459.529165,
      "vol24hAMM": 14322.060559,
      "vol24htx": 2213,
      "vol24htxAMM": 869
    },
    {
      "_id": "b05f7c8e58b832c74267d988567dea33",
      "amount": "320929544035.02521966",
      "supply": "320929544035.02521966",
      "trustlines": 12280,
      "offers": 586,
      "holders": 11277,
      "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.00003930479419703379,
      "time": 1792387400000,
      "usd": "0.000051471593240725599695",
      "assessmentScore": 0.3,
      "trendingScore": 76.36,
      "maxMin24h": [
        0.00004215632072540515,
        0.00003743999993729004
      ],
      "dom": 1.3675,
      "id": 3,
      "marketcap": 12614069.680044558,
      "p24h": -2.3596660222104e-7,
      "p7d": 0.00000700479425601817,
      "pro24h": -0.5967679868857934,
      "pro7d": 21.68666956287899,
      "holders24h": 26,
      "marketcap24h": -99680.2130451221,
      "trustlines24h": 48,
      "p1h": -6.6600729e-13,
      "p5m": 0,
      "pro1h": -0.0000016944682990072124,
      "pro5m": 0,
      "domain": "fuzzyxrp.com",
      "origin": "FirstLedger",
      "social": {
        "twitter": "fuzzy_xrp",
        "telegram": "fuzzyxrp"
      },
      "user": "Fuzzybear"
    },
    {
      "_id": "00d32006174e7600cb1451ae971e9443",
      "amount": "222149892127.57063822",
      "supply": "222149892127.57063822",
      "trustlines": 744,
      "offers": 47,
      "holders": 458,
      "issuer": "rExSpmk2PAqxKRTT3mhjCrCpqVasBra5v8",
      "currency": "54494D4500000000000000000000000000000000",
      "name": "TIME",
      "md5": "00d32006174e7600cb1451ae971e9443",
      "slug": "rExSpmk2PAqxKRTT3mhjCrCpqVasBra5v8-54494D4500000000000000000000000000000000",
      "ext": "webp",
      "dateon": 1756987929121,
      "date": "2025-09-04",
      "kyc": false,
      "verified": false,
      "hashicon": false,
      "highConcentrationRisk": true,
      "exch": 7.762790392615258e-7,
      "time": 1792387550000,
      "usd": "0.0000010172360530483034083",
      "assessmentScore": 0.4,
      "trendingScore": 19.09,
      "AMM": "rQEwagDWWQzB3a3LuxkiZ9rxHwzzshrr89",
      "lastUpdated": "2026-10-19T05:26:24.015Z",
      "tvl": 14950.615068,
      "buyerPressure": 1.63,
      "uniqueTraderGrowth": 98.2532751091703,
      "volumePerTrader": 177.5,
      "id": 4,
      "marketcap": 172450.30483284214,
      "p1h": 1.26941422948565e-8,
      "p24h": 3.619110917707771e-7,
      "p5m": 7.5348237540347e-9,
      "p7d": 6.183501140481652e-7,
      "pro1h": 1.6624402008583283,
      "pro24h": 87.34051317491378,
      "pro5m": 0.9801470504803067,
      "pro7d": 391.53696082765055,
      "tags": [
        "FirstLedger",
        "Memes",
        "Hot",
        "Overbought",
        "Volatile"
      ]
    },
    {
      "_id": "cd9499746c1b2e041563a9724330b3e6",
      "amount": "588556703.26365399236",
      "supply": "588556703.26365399236",
      "trustlines": 22650,
      "offers": 623,
      "holders": 21973,
      "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.005229565303784382,
      "time": 1792387461000,
      "usd": "0.0068492139740194429492",
      "assessmentScore": 0.39,
      "trendingScore": 76.34,
      "maxMin24h": [
        0.005300737329396574,
        0.004729999999999997
      ],
      "dom": 0.3337,
      "id": 5,
      "marketcap": 3077895.7146973247,
      "p24h": 0.00016522512820166,
      "p7d": -0.000155610279216548,
      "pro24h": 3.26252033775849,
      "pro7d": -2.8896045601141562,
      "holders24h": 7,
      "marketcap24h": 97311.78594365995,
      "trustlines24h": 24,
      "p1h": 0.000005506628932992,
      "p5m": 0,
      "pro1h": 0.10540901769537925,
      "pro5m": 0,
      "domain": "xrparmytoken.com",
      "origin": "FirstLedger",
      "social": {
        "twitter": "ARMY_XRP589",
        "telegram": "XRP_Army_CTO"
      },
      "user": "ARMY"
    }
  ],
  "exch": {
    "USD": 0.7635235991536182,
    "EUR": 0.8571926742977841,
    "JPY": 0.004832030270633544,
    "CNY": 0.11428112124554612
  },
  "H24": {
    "_id": "METRICS_24H",
    "activeAddresses24H": 19264,
    "tradedTokens24H": 1944,
    "tradedXRP24H": 4137904.92765,
    "transactions24H": 122770,
    "lastUpdated": "2026-10-19T05:26:14.007Z",
    "updateStatus": "complete",
    "uniqueTraders24H": 7726,
    "xrpPro24h": 1.1833446037157858,
    "totalTVLPro": -0.07088042340765988,
    "globalBuy24hAMM": 310978.52238200005,
    "globalBuy24hOrderbook": 1740902.4712869986,
    "globalBuy24htx": 73183,
    "globalBuy24hxrp": 2051880.9936689972,
    "globalSell24hAMM": 318456.90584000055,
    "globalSell24hOrderbook": 1767569.0571840005,
    "globalSell24htx": 49593,
    "globalSell24hxrp": 2086025.9630240009,
    "globalVol24hAMM": 629435.4282220006,
    "globalVol24hOrderbook": 3508471.528471,
    "globalDeposit24htx": 601,
    "globalDeposit24hxrp": 11166.822633999998,
    "globalWithdraw24htx": 145,
    "globalWithdraw24hxrp": 12379.828956000001,
    "transactions24HPro": 40.23784228383427,
    "globalTrades24hAMM": 86656,
    "globalTrades24hOrderbook": 36120,
    "uniqueTraders24hAMM": 7155,
    "uniqueTraders24hOrderbook": 1803,
    "globalAmmCreate24htx": 1,
    "globalAmmCreate24hxrp": 25.019
  },
  "global": {
    "_id": "METRICS_GLOBAL",
    "gDexVolume": 4137949.184496,
    "gDexVolumePro": 36.891972889984274,
    "gMarketcap": 922388239.349859,
    "gMarketcapPro": -1.7659171269884477,
    "gNFTIOUVolume": 0,
    "gNFTIOUVolumePro": 0,
    "gScamVolume": 13609.575182,
    "gScamVolumePro": 0.32889662427446265,
    "gStableVolume": 3443800.9322510003,
    "gStableVolumePro": 83.2248241509146,
    "gXRPdominance": 98.55993976251263,
    "gXRPdominancePro": 0.025887420769854508,
    "gMemeVolume": 525966.6327,
    "gMemeVolumePro": 12.710804537442922,
    "sentimentScore": 48,
    "totalAddresses": 8527748,
    "totalOffers": 184752,
    "totalTrustLines": 6876034,
    "avgRSI15m": 50.56,
    "avgRSI1h": 46.73,
    "avgRSI24h": 64.54,
    "avgRSI4h": 54.9,
    "avgRSI7d": 62.83,
    "avgRSI": 58.33,
    "avgRSI30d": 55.12,
    "avgRSI90d": 49.92,
    "totalTVL": 24481944.179303903,
    "gUniqueTraders": 7727,
    "gUniqueTradersPro": -5.572528412562628,
    "lastUpdated": "2026-10-19T05:26:06.012Z",
    "gTransactions24HPro": 40.23784228383427
  }
}

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