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 response22 ms · just now · 3.3 KB · 106 lines
https://api.xrpl.to/v1/testnet/tokens?limit=5
{
  "success": true,
  "took": 16,
  "sortBy": "vol24h",
  "tokens": [
    {
      "_id": "3e22ff85edaacd811f9781d7c3ce7698",
      "currency": "564F4C5400000000000000000000000000000000",
      "exch": 6.697076722141353,
      "firstSeen": 1793416531000,
      "firstTx": "5179C66860C8ECDEFBE72F96F73D6404908C0A72EBA8BC8B13A2CCD05D583469",
      "holders": 55,
      "issuer": "rnz7aAbDDoAVCk1YoQ1HLYC4U9xz3TNTMj",
      "name": "VOLT",
      "supply": 25466.463600000006,
      "trades24h": 286,
      "trustlines": 69,
      "vol24h": 104414.090684,
      "time": 1795281932000,
      "amm": "rUYTeeJoVC433MkSXiQVKEwZkEX7oRnm9F",
      "spot": 7.196803204391879,
      "tvl": 2659.2397,
      "lastTrade": 1795281932000
    },
    {
      "_id": "2b5e3c50d0500edf86212000b9883dce",
      "currency": "524C555344000000000000000000000000000000",
      "exch": 1.067992485704291,
      "firstSeen": 1793416940000,
      "firstTx": "F6E345F7D7B7CD8B5F65BAD88B4EAD18049CFA7F262981FBD8E2996B8C153D4D",
      "holders": 30,
      "issuer": "rKmPxq4hD4m27cVy7kqRmwnV59rXVwWML7",
      "name": "RLUSD",
      "supply": 25959.508408858583,
      "trades24h": 1619,
      "trustlines": 35,
      "vol24h": 46331.893673,
      "time": 1795282251000,
      "amm": "rHh8QTC8Jr8dEwzUWTQxdFF3ZBhKGp1gAk",
      "spot": 1.067613698732757,
      "tvl": 46398.529876,
      "lastTrade": 1795282251000
    },
    {
      "_id": "a01efe8cfebae174ef6efcb89dc47e7f",
      "currency": "4445455000000000000000000000000000000000",
      "exch": 0.26009190085655814,
      "firstSeen": 1793416430000,
      "firstTx": "C08387BF76B46470385EE1584C73062872923516C00AA35A5B23FC97E49ED75B",
      "holders": 22,
      "issuer": "rhuZ8V91S6vMD7cegHuKTJ8xxPbKmF6LmW",
      "name": "DEEP",
      "supply": 88447.72530000015,
      "trades24h": 512,
      "trustlines": 34,
      "vol24h": 5688.859614,
      "time": 1795282260000,
      "amm": "rBYSka7yNzSpV9PyQ4Jd8FtoFTi3JCAwrm",
      "spot": 0.26109843428844043,
      "tvl": 7997.045004,
      "lastTrade": 1795282251000
    },
    {
      "_id": "f6e360ef20c70f82e4d298c78772e2c6",
      "currency": "TSB",
      "exch": 2.7791691574554767,
      "firstSeen": 1792851013000,
      "firstTx": "D09DF1A2F6F34DF7753875A3428C8E9048F89F5E864D4737CC0F1983BA3CEA47",
      "holders": 19,
      "issuer": "rBfBwcWEgd9rhX4qeyXUgXVMViogTw6NNE",
      "name": "TSB",
      "supply": 1999.9999999998856,
      "trades24h": 2902,
      "trustlines": 20,
      "vol24h": 1782.53041,
      "time": 1795282381000,
      "amm": "rp6viYfTbHRQz2CKYJW9pH8fkikZhoomjn",
      "spot": 2.7849968465594173,
      "tvl": 376.417098,
      "lastTrade": 1795282381000
    },
    {
      "_id": "d252db0d26944dae2b8871317cbda10d",
      "currency": "TSE",
      "exch": 0.12740228288465544,
      "firstSeen": 1792851032000,
      "firstTx": "66252A837B4B6433BF77096654E1FB6845B36E47C1BF3DF0AB79C91E522B9F3C",
      "holders": 16,
      "issuer": "rBfBwcWEgd9rhX4qeyXUgXVMViogTw6NNE",
      "name": "TSE",
      "supply": 8000.00000000005,
      "trades24h": 2824,
      "trustlines": 20,
      "vol24h": 1739.8541,
      "time": 1795282352000,
      "amm": "rLpN4LFG6gY3s9MMJ95nFs6mmb7zEpY8Cc",
      "spot": 0.12764708162503202,
      "tvl": 163.686888,
      "lastTrade": 1795282352000
    }
  ],
  "count": 5,
  "total": 50981,
  "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