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 response22 ms · just now · 3.2 KB · 103 lines
https://api.xrpl.to/v1/testnet/tokens?limit=5
{
  "success": true,
  "took": 21,
  "sortBy": "vol24h",
  "tokens": [
    {
      "_id": "f4287b62ba9a507908b24bda56e4ff1b",
      "currency": "564F4C5400000000000000000000000000000000",
      "exch": 5998.157163400644,
      "firstSeen": 1790612601000,
      "firstTx": "5F9A66C11F5ECC194B0710EC6EB0402FF0A67082D4EB3F811D4DF8A646A1C6B1",
      "holders": 600,
      "issuer": "rNmqLvw9pFuDBBD3D15D9Ttd28q3f5P5Pv",
      "name": "VOLT",
      "supply": 52584.2308,
      "trades24h": 552,
      "trustlines": 888,
      "vol24h": 15049168.30569,
      "time": 1792398941000,
      "amm": "rBEYigdZqzjN4u3brwbfSFKopBDVsvpkG1",
      "spot": 5363.14799630287,
      "tvl": 417046.60294,
      "lastTrade": 1792398941000
    },
    {
      "_id": "ecfb8f46ab12687bf34adeda926a9adb",
      "currency": "524C555344000000000000000000000000000000",
      "exch": 0.7606220909925351,
      "firstSeen": 1790612990000,
      "firstTx": "982F592E11D366807BC88857F5822931062D42B6C9DFD89C146966DECC6C71B0",
      "holders": 608,
      "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
      "name": "RLUSD",
      "supply": 533881.3128841454,
      "trades24h": 4298,
      "trustlines": 612,
      "vol24h": 262621.434104,
      "time": 1792398950000,
      "amm": "rPZ4iweTw9ficJh4eRKFPSUPnZE7RZnykT",
      "spot": 0.7609938740174453,
      "tvl": 63643.147448,
      "lastTrade": 1792398950000
    },
    {
      "_id": "a81ca1d210d03dbf4c05f8d0a068e0d2",
      "currency": "5249504C00000000000000000000000000000000",
      "exch": 134142911.48021254,
      "firstSeen": 1790616372000,
      "firstTx": "62B3C3BB7FBFFAAB4F1F5F426A8CF13969683F4AB5E3881CD7AA755BAE2121D7",
      "holders": 641,
      "issuer": "rHxyYNNzCY6eK3xAMH9JzT4DxGUnZeG2fj",
      "name": "RIPL",
      "supply": 55099.20319999995,
      "trades24h": 125,
      "trustlines": 643,
      "vol24h": 118126.231364,
      "time": 1792398650000,
      "amm": "rf5BMXZaaCpwZHKAbTqfGXF2NHoHT1A1W8",
      "spot": 134114292.6444512,
      "tvl": 2006041.26298,
      "lastTrade": 1792398650000
    },
    {
      "_id": "28f99a9e095b998c962d30b6e70da997",
      "currency": "424C4B4800000000000000000000000000000000",
      "exch": 23610285.102817185,
      "firstSeen": 1790616110000,
      "firstTx": "AB1ADE7CE2B8AB13AA8BD58FA1F393DEF337D21DDCE31C29DDA6021FA4728265",
      "holders": 598,
      "issuer": "rDCaWfxEasyEZocudzc7zeRgFix6aBnLBt",
      "name": "BLKH",
      "supply": 86550.66709999998,
      "trades24h": 122,
      "trustlines": 4593,
      "vol24h": 114233.034517,
      "time": 1792398931000,
      "amm": "rUY9rjsgfQ4fHaS3tssqR1GaiWGHsaYguX",
      "spot": 23456358.39828258,
      "tvl": 799735.105114,
      "lastTrade": 1792398050000
    },
    {
      "_id": "27397fb3e62fb3aa3e523a610d842130",
      "currency": "WAR",
      "exch": 1.959240110326921,
      "firstSeen": 1789944332000,
      "firstTx": "51574A15CF6A90E9EFBD702709B21AA1A89A19C92364E101BB5C94B3F865542D",
      "holders": 5,
      "issuer": "rQGbw4Q5jqq2t25r4vjsyRksXvoM1o2Jf6",
      "name": "WAR",
      "supply": 7379.999999999888,
      "trades24h": 11755,
      "trustlines": 5,
      "vol24h": 100590.881175,
      "lastTrade": 1792398941000,
      "time": 1792398941000
    }
  ],
  "count": 5,
  "total": 11557,
  "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}