XRPL.to
GET /testnet/tokens
GET

/v1/testnet/tokens

Testnet tokens. tvl is the token's XRP pool valued on both sides (twice its XRP reserve); a token with no XRP pool has none

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/testnet/tokens?limit=5
Query parameterValueDescription
sortvol24h | holders | trades24h | trustlines | tvl | firstSeen (default vol24h)
limit1-100 (default 50)
pagefrom 1
curl 'https://api.xrpl.to/v1/testnet/tokens?limit=5'

Response

200Example response6 ms · just now · 3.2 KB · 103 lines
https://api.xrpl.to/v1/testnet/tokens?limit=5
{
  "success": true,
  "took": 6,
  "sortBy": "vol24h",
  "tokens": [
    {
      "_id": "2b5e3c50d0500edf86212000b9883dce",
      "currency": "524C555344000000000000000000000000000000",
      "exch": 0.7994417870000002,
      "firstSeen": 1793416940000,
      "firstTx": "F6E345F7D7B7CD8B5F65BAD88B4EAD18049CFA7F262981FBD8E2996B8C153D4D",
      "holders": 28,
      "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
      "name": "RLUSD",
      "supply": 34589.64226132721,
      "trades24h": 4682,
      "trustlines": 29,
      "vol24h": 249002.047837,
      "time": 1793516661000,
      "amm": "rHh8QTC8Jr8dEwzUWTQxdFF3ZBhKGp1gAk",
      "spot": 0.7994417869829618,
      "tvl": 40076.867978,
      "lastTrade": 1793516661000
    },
    {
      "_id": "27397fb3e62fb3aa3e523a610d842130",
      "currency": "WAR",
      "exch": 1.9819053697971925,
      "firstSeen": 1789944332000,
      "firstTx": "51574A15CF6A90E9EFBD702709B21AA1A89A19C92364E101BB5C94B3F865542D",
      "holders": 5,
      "issuer": "rQGbw4Q5jqq2t25r4vjsyRksXvoM1o2Jf6",
      "name": "WAR",
      "supply": 13079.999999999725,
      "trades24h": 10072,
      "trustlines": 6,
      "vol24h": 79788.030663,
      "lastTrade": 1793516671000,
      "time": 1793516671000
    },
    {
      "_id": "a01efe8cfebae174ef6efcb89dc47e7f",
      "currency": "4445455000000000000000000000000000000000",
      "exch": 1.4034717202027938,
      "firstSeen": 1793416430000,
      "firstTx": "C08387BF76B46470385EE1584C73062872923516C00AA35A5B23FC97E49ED75B",
      "holders": 21,
      "issuer": "rhuZ8V91S6vMD7cegHuKTJ8xxPbKmF6LmW",
      "name": "DEEP",
      "supply": 88447.72529999996,
      "trades24h": 1726,
      "trustlines": 28,
      "vol24h": 56542.614722,
      "time": 1793516642000,
      "amm": "rBYSka7yNzSpV9PyQ4Jd8FtoFTi3JCAwrm",
      "spot": 1.3973494188987206,
      "tvl": 16607.135686,
      "lastTrade": 1793516630000
    },
    {
      "_id": "3e22ff85edaacd811f9781d7c3ce7698",
      "currency": "564F4C5400000000000000000000000000000000",
      "exch": 1.24331467708084,
      "firstSeen": 1793416531000,
      "firstTx": "5179C66860C8ECDEFBE72F96F73D6404908C0A72EBA8BC8B13A2CCD05D583469",
      "holders": 53,
      "issuer": "rnz7aAbDDoAVCk1YoQ1HLYC4U9xz3TNTMj",
      "name": "VOLT",
      "supply": 25466.4636,
      "trades24h": 596,
      "trustlines": 62,
      "vol24h": 24670.522888,
      "time": 1793516651000,
      "amm": "rUYTeeJoVC433MkSXiQVKEwZkEX7oRnm9F",
      "spot": 1.2463385310882837,
      "tvl": 196.328322,
      "lastTrade": 1793516651000
    },
    {
      "_id": "c6f28146ae8ee1dbbbb83a99fdc2175b",
      "currency": "MKL",
      "exch": 138.85554033967864,
      "firstSeen": 1792798092000,
      "firstTx": "79184CF1B936097062CE623E82C9673F1CD30F2F478140696194BF803D196C10",
      "holders": 14,
      "issuer": "rMJ7kcp3s1oZHhQ78UDEqYNvmEoeDajabd",
      "name": "MKL",
      "supply": 13359.519221414268,
      "trades24h": 1963,
      "trustlines": 19,
      "vol24h": 19413.029022,
      "time": 1793516680000,
      "amm": "rpKxUXDZ7RQdHWAc95K3BBtKmKn5bhf8nC",
      "spot": 138.52150576145326,
      "tvl": 18462.178394,
      "lastTrade": 1793516661000
    }
  ],
  "count": 5,
  "total": 17928,
  "page": 1,
  "limit": 5
}
Shapeas documented
{
  tokens: [
    {
      _id (md5),
      issuer,
      currency,
      name,
      exch,
      spot,
      amm,
      vol24h,
      trades24h,
      holders,
      trustlines,
      supply,
      firstSeen
    }
  ],
  count,
  total,
  page,
  limit,
  sortBy
}

What it does

Testnet tokens. tvl is the token's XRP pool valued on both sides (twice its XRP reserve); a token with no XRP pool has none

Start at GET /v1/testnet/fixtures: it names live accounts, a busy token, an NFT with offers and one of every ledger object that xrpl.to keeps alive on Testnet, plus a real transaction of every type. The busiest token gains holders every hour, so its GET /v1/testnet/tokens/{md5}/holders is the place to test paginating a long list. Testnet resets without warning; the data is rebuilt from the chain within minutes, and only objects touched since count. Open the Testnet sandbox →
OpenAPI
PrevGET/testnet/healthNextGET/testnet/tokens/{md5}