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 response12 ms · just now · 3.2 KB · 103 lines
https://api.xrpl.to/v1/testnet/tokens?limit=5
{
  "success": true,
  "took": 1,
  "sortBy": "vol24h",
  "tokens": [
    {
      "_id": "23ba49b21cbc55d2bd9a2a061957086e",
      "currency": "56454C4158000000000000000000000000000000",
      "exch": 918.7214432222589,
      "firstSeen": 1789944350000,
      "firstTx": "32DA9E5BF731C8732EA763E5B0DF6AE707BDAF3932266158EC19FCC0757A68B7",
      "holders": 103,
      "issuer": "rDtb4JAujk7zJPFVtGaJQpbc7HzZG5frbs",
      "name": "VELAX",
      "supply": 20071.62612738382,
      "trades24h": 362,
      "trustlines": 110,
      "vol24h": 152964.240677,
      "amm": "rsbGzWhoSpcoE6sBWq18QzfKyZh7aA692C",
      "lastTrade": 1789974670000,
      "spot": 948.8239870056804,
      "time": 1789975030000,
      "tvl": 29223.95036
    },
    {
      "_id": "12989284778980e987410b6e10cf7f9c",
      "currency": "524C555344000000000000000000000000000000",
      "exch": 0.6956612681407898,
      "firstSeen": 1789944340000,
      "firstTx": "2BADBABD9B15ACE6D1CE80BD1C451CEF6A7DF2C05BBA12C5FBD1E17BD4678DAA",
      "holders": 119,
      "issuer": "rNuFETH1NSTxZQYmDvPWdMF8dD3FbTzbmP",
      "name": "RLUSD",
      "supply": 116308.90695298817,
      "trades24h": 1702,
      "trustlines": 131,
      "vol24h": 125768.030359,
      "amm": "rEc17YM54zCGkzHfnNGtrp1dR31ACUYhep",
      "lastTrade": 1789975862000,
      "spot": 0.6960572959636605,
      "time": 1789975862000,
      "tvl": 38721.10668
    },
    {
      "_id": "27397fb3e62fb3aa3e523a610d842130",
      "currency": "WAR",
      "exch": 1.9847805366578666,
      "firstSeen": 1789944332000,
      "firstTx": "51574A15CF6A90E9EFBD702709B21AA1A89A19C92364E101BB5C94B3F865542D",
      "holders": 5,
      "issuer": "rQGbw4Q5jqq2t25r4vjsyRksXvoM1o2Jf6",
      "name": "WAR",
      "supply": 1979.9999999999995,
      "trades24h": 3383,
      "trustlines": 5,
      "vol24h": 19941.103693,
      "lastTrade": 1789975891000,
      "time": 1789975891000
    },
    {
      "_id": "8ce8d051648d9b9645836c58afdcaf2e",
      "currency": "4445455000000000000000000000000000000000",
      "exch": 1.9451584181202708,
      "firstSeen": 1789967862000,
      "firstTx": "540B9472005ED0978944867841B83B6DC4004019980B30AFE143AC4238F1B4BF",
      "holders": 186,
      "issuer": "rBsTWpza7J6PRRhSzWZ9XhU5w65deaXv6M",
      "name": "DEEP",
      "supply": 92014.8959,
      "trades24h": 182,
      "trustlines": 187,
      "vol24h": 5384.084468,
      "time": 1789975850000,
      "amm": "rUU1ELMLU73U94U6w8DeQAikCtsvvKUUen",
      "spot": 1.935910084002762,
      "lastTrade": 1789975850000,
      "tvl": 18904.121428
    },
    {
      "_id": "c2ec1eba5478475f7c09ed4637408876",
      "currency": "564F4C5400000000000000000000000000000000",
      "exch": 1.8189154222494412,
      "firstSeen": 1789967960000,
      "firstTx": "9FA206237BAFC177A30B7568027228EC00D8ADE63B9936C3E343D02CB8ECC7FD",
      "holders": 17,
      "issuer": "rUfzQ6XdytZ2GBbZoQTUBjnda3fVDBwai2",
      "name": "VOLT",
      "supply": 35307.148,
      "trades24h": 53,
      "trustlines": 19,
      "vol24h": 619.59281,
      "time": 1789975852000,
      "amm": "rGkpj9FdtyKiB324xqDq6Z8kRDaGqTuMfi",
      "spot": 1.7774658871929745,
      "lastTrade": 1789975852000,
      "tvl": 213.288598
    }
  ],
  "count": 5,
  "total": 109,
  "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. Testnet resets without warning; the data is rebuilt from the chain within minutes, and only objects touched since count. Open the Testnet sandbox →
OpenAPI