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|athDistance|name (unknown field = no-op; a token with no value for the field is listed last in both orders; text is ordered from its first letter or digit)
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)
min_vol24hxrpnumber - only tokens with at least this 24h volume in XRP; with sort=pro24h, the gainers that actually traded
curl 'https://api.xrpl.to/v1/tokens?limit=5&sort=vol24hxrp'

Response

200Example response2 ms · just now · 9.8 KB · 335 lines
https://api.xrpl.to/v1/tokens?limit=5&sort=vol24hxrp
{
  "success": true,
  "took": 0,
  "total": 20613,
  "count": 5,
  "tagName": "",
  "start": 0,
  "limit": 5,
  "sortBy": "vol24hxrp",
  "sortType": "desc",
  "tokens": [
    {
      "_id": "0dd550278b74cb6690fdae351e8e0df3",
      "amount": "768557088.45164571331",
      "supply": "768557088.45164571331",
      "trustlines": 103260,
      "offers": 10719,
      "holders": 68205,
      "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": 1.071231098861469,
      "time": 1795282382000,
      "usd": "1.0014403927706442947",
      "assessmentScore": 0.1,
      "trendingScore": 0.88,
      "maxMin24h": [
        1.16144414973598,
        1.069151660158817
      ],
      "dom": 84.3063,
      "id": 1,
      "marketcap": 823302254.3998277,
      "p24h": -0.0374841249696792,
      "p7d": 0.037749166731039,
      "pro24h": -3.380861393798973,
      "pro7d": 3.652619901464793,
      "holders24h": 25,
      "marketcap24h": -534528.9466508627,
      "trustlines24h": 74,
      "social": {
        "twitter": "ripple"
      },
      "tags": [
        "Stablecoin",
        "Ripple",
        "XRPL",
        "United States"
      ],
      "user": "Ripple",
      "domain": "ripple.com",
      "whitepaper": "https://ripple.com/reports/rlusd-whitepaper.pdf",
      "p1h": -0.0073011419772511,
      "p5m": 0.00109318480333
    },
    {
      "_id": "1c54f16ec1b45eef983f202b9954999b",
      "amount": "3071338.6989032426499",
      "supply": "3071338.6989032426499",
      "trustlines": 15413,
      "offers": 1298,
      "holders": 10506,
      "issuer": "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE",
      "currency": "5553444300000000000000000000000000000000",
      "name": "USDC",
      "md5": "1c54f16ec1b45eef983f202b9954999b",
      "slug": "rGm7WCVp9gb4jZHWTEtGUr4dd74z2XuWhE-5553444300000000000000000000000000000000",
      "dateon": 1744730619450,
      "date": "2025-04-15",
      "kyc": true,
      "verified": 1,
      "hashicon": false,
      "tvl": 279866.696912,
      "assessmentScore": 0.38,
      "trendingScore": 0.8,
      "exch": 1.0714550106721332,
      "time": 1795282371000,
      "usd": "1.001488998475242902",
      "AMM": "rM7cHVPfhe9yxQNk2kDNBEQqoQmMcQGPWE",
      "lastUpdated": "2026-11-21T17:33:04.012Z",
      "maxMin24h": [
        1.161926011332509,
        1.0694284355613792
      ],
      "dom": 0.337,
      "id": 2,
      "marketcap": 3290801.2384111094,
      "p1h": -0.0066420413597215,
      "p24h": -0.0365781831546218,
      "p5m": 0.0014143434353702,
      "p7d": 0.0378388685610877,
      "pro1h": -0.6160893722140681,
      "pro24h": -3.3011811702403637,
      "pro5m": 0.13217660586886115,
      "pro7d": 3.660824073800373,
      "vol24h": 1326004.684098,
      "vol24hAMM": 120590.989647,
      "vol24htx": 10791,
      "vol24htxAMM": 5030
    },
    {
      "_id": "b05f7c8e58b832c74267d988567dea33",
      "amount": "320929089459.13398781",
      "supply": "320929089459.13398781",
      "trustlines": 13453,
      "offers": 685,
      "holders": 12006,
      "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.0000565139471871169,
      "time": 1795282251000,
      "usd": "0.00005289140317242270671",
      "assessmentScore": 0.51,
      "trendingScore": 61.1,
      "maxMin24h": [
        0.0000581248069311286,
        0.000054111157181756317
      ],
      "dom": 1.8572,
      "id": 3,
      "marketcap": 18136969.61250301,
      "p24h": -0.000001165334046750384,
      "p7d": 0.00000488319520109108,
      "pro24h": -2.020368530643446,
      "pro7d": 9.457919966791772,
      "holders24h": 10,
      "marketcap24h": -352829.46301338077,
      "trustlines24h": 16,
      "p1h": -2.3656589515435e-7,
      "p5m": 5.536144369e-11,
      "pro1h": -0.41685243411173634,
      "pro5m": 0.00009796077016233085,
      "domain": "fuzzyxrp.com",
      "origin": "FirstLedger",
      "social": {
        "twitter": "fuzzy_xrp",
        "telegram": "fuzzyxrp"
      },
      "user": "Fuzzybear"
    },
    {
      "_id": "0f036e757e4aca67a2d4ae7aab638a95",
      "md5": "0f036e757e4aca67a2d4ae7aab638a95",
      "amount": "40506925.663560633722",
      "currency": "CNY",
      "date": "2015-03-19",
      "dateon": 1426723200000,
      "domain": "ripplefox.com",
      "holders": 11774,
      "issuer": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y",
      "kyc": true,
      "offers": 2786,
      "trustlines": 18555,
      "user": "RippleFox",
      "verified": 1,
      "name": "CNY",
      "social": {
        "telegram": "ripplefoxgroup"
      },
      "tags": [
        "Stablecoin",
        "RippleFox"
      ],
      "exch": 0.1591546406225034,
      "marketcap": 4664785.593712766,
      "maxMin24h": [
        0.16949154122952617,
        0.15895829152937402
      ],
      "p24h": -0.00426449562267047,
      "p7d": 0.00661743209990734,
      "pro24h": -2.6095448309508606,
      "pro7d": 4.338241248807861,
      "id": 4,
      "supply": "29309768.005930180122",
      "usd": "0.14892895496250757247",
      "time": 1795282152000,
      "lines": 17754,
      "dom": 0.4777,
      "slug": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y-CNY",
      "holders24h": 1,
      "marketcap24h": -122574.36019651499,
      "trustlines24h": 3,
      "trendingScore": 5.76,
      "assessmentScore": 0.22,
      "p1h": -0.00081396709684375,
      "p5m": 0,
      "pro1h": -0.5088292687223994,
      "pro5m": 0
    },
    {
      "_id": "a7cde93c44b168524a4de4de03750340",
      "md5": "a7cde93c44b168524a4de4de03750340",
      "amount": "4934939.6152617705876",
      "currency": "USD",
      "date": "2015-02-21",
      "dateon": 1424476800000,
      "domain": "gatehub.net",
      "holders": 20482,
      "issuer": "rhub8VRN55s94qWKDv6jmDy1pUykJzF3wq",
      "kyc": true,
      "offers": 4540,
      "social": {
        "facebook": "GateHubNet",
        "linkedin": "gatehub-limited",
        "reddit": "r/gatehub",
        "twitter": "GateHub"
      },
      "trustlines": 115452,
      "user": "GateHub",
      "verified": 1,
      "name": "USD",
      "tags": [
        "Stablecoin",
        "GateHub",
        "Slovenia"
      ],
      "exch": 0.9778280998365555,
      "marketcap": 3767702.136798356,
      "maxMin24h": [
        1.0869565217391304,
        0.8729812308619671
      ],
      "p24h": -0.0221927445881388,
      "p7d": 0.0049252079341928,
      "pro24h": -2.2192282002787778,
      "pro7d": 0.5062383897906031,
      "id": 5,
      "supply": "3853133.4264459466876",
      "usd": "0.91397592491722842585",
      "time": 1795282372000,
      "lines": 111825,
      "dom": 0.3858,
      "slug": "rhub8VRN55s94qWKDv6jmDy1pUykJzF3wq-USD",
      "holders24h": 7,
      "marketcap24h": -38168.63952317834,
      "trustlines24h": 2,
      "trendingScore": 2.1,
      "assessmentScore": 0.19,
      "p1h": -0.0366379406171425,
      "p5m": -0.0366379406171425,
      "pro1h": -3.611549244246459,
      "pro5m": -3.611549244246459
    }
  ],
  "exch": {
    "USD": 1.0698619878035733,
    "EUR": 1.1709211511714988,
    "JPY": 0.00685628769236017,
    "CNY": 0.16031257309451769
  },
  "H24": {
    "_id": "METRICS_24H",
    "activeAddresses24H": 41560,
    "tradedTokens24H": 2131,
    "tradedXRP24H": 13267196.696759,
    "transactions24H": 149764,
    "lastUpdated": "2026-11-21T17:32:41.424Z",
    "updateStatus": "complete",
    "uniqueTraders24H": 9197,
    "xrpPro24h": 3.4761430311081476,
    "totalTVLPro": -0.2910841839047884,
    "globalBuy24hAMM": 512245.09358800005,
    "globalBuy24hOrderbook": 6197447.4250880005,
    "globalBuy24htx": 82773,
    "globalBuy24hxrp": 6709692.518675999,
    "globalSell24hAMM": 553772.7439549989,
    "globalSell24hOrderbook": 6003731.434128002,
    "globalSell24htx": 66991,
    "globalSell24hxrp": 6557504.178083,
    "globalVol24hAMM": 1066017.837542999,
    "globalVol24hOrderbook": 12201178.859215997,
    "globalDeposit24htx": 1465,
    "globalDeposit24hxrp": 8312.553821,
    "globalWithdraw24htx": 128,
    "globalWithdraw24hxrp": 22072.650909999997,
    "transactions24HPro": 4.4090075899609005,
    "globalTrades24hAMM": 88843,
    "globalTrades24hOrderbook": 60921,
    "uniqueTraders24hAMM": 8517,
    "uniqueTraders24hOrderbook": 2056,
    "globalAmmCreate24htx": 39,
    "globalAmmCreate24hxrp": 8240.1039855
  },
  "global": {
    "_id": "METRICS_GLOBAL",
    "gDexVolume": 13256563.340986,
    "gDexVolumePro": 13.398988917122946,
    "gMarketcap": 977901764.0591445,
    "gMarketcapPro": -0.9442604189576653,
    "gNFTIOUVolume": 0,
    "gNFTIOUVolumePro": 0,
    "gScamVolume": 27155.198128,
    "gScamVolumePro": 0.20484342306156283,
    "gStableVolume": 12696749.435499001,
    "gStableVolumePro": 95.77708120055374,
    "gXRPdominance": 98.48374414580124,
    "gXRPdominancePro": 0.014453886207799194,
    "gMemeVolume": 304559.028711,
    "gMemeVolumePro": 2.297420687980113,
    "sentimentScore": 53,
    "totalAddresses": 8700566,
    "totalOffers": 183089,
    "totalTrustLines": 6892228,
    "avgRSI15m": 46.43,
    "avgRSI1h": 50.51,
    "avgRSI24h": 52.54,
    "avgRSI4h": 50.52,
    "avgRSI7d": 54.97,
    "avgRSI": 52.03,
    "avgRSI30d": 49.58,
    "avgRSI90d": 53.24,
    "totalTVL": 26820732.84697401,
    "gUniqueTraders": 9201,
    "gUniqueTradersPro": 8.1198589894242,
    "lastUpdated": "2026-11-21T17:32:06.078Z",
    "gTransactions24HPro": 4.4090075899609005
  }
}

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