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 response5 ms · just now · 3.4 KB · 106 lines
https://api.xrpl.to/v1/testnet/tokens?limit=5
{
  "success": true,
  "took": 4,
  "sortBy": "vol24h",
  "tokens": [
    {
      "_id": "f4287b62ba9a507908b24bda56e4ff1b",
      "currency": "564F4C5400000000000000000000000000000000",
      "exch": 31212.71682454772,
      "firstSeen": 1790612601000,
      "firstTx": "5F9A66C11F5ECC194B0710EC6EB0402FF0A67082D4EB3F811D4DF8A646A1C6B1",
      "holders": 599,
      "issuer": "rNmqLvw9pFuDBBD3D15D9Ttd28q3f5P5Pv",
      "name": "VOLT",
      "supply": 52584.2308,
      "trades24h": 458,
      "trustlines": 813,
      "vol24h": 9249339.756896,
      "time": 1791766700000,
      "amm": "rBEYigdZqzjN4u3brwbfSFKopBDVsvpkG1",
      "spot": 28861.19463107815,
      "tvl": 190163.053444,
      "lastTrade": 1791766700000
    },
    {
      "_id": "ecfb8f46ab12687bf34adeda926a9adb",
      "currency": "524C555344000000000000000000000000000000",
      "exch": 0.710992908,
      "firstSeen": 1790612990000,
      "firstTx": "982F592E11D366807BC88857F5822931062D42B6C9DFD89C146966DECC6C71B0",
      "holders": 605,
      "issuer": "rLgZXamWAfiuShiArGu1ZphyjymKX1QKs1",
      "name": "RLUSD",
      "supply": 911380.4526949316,
      "trades24h": 3615,
      "trustlines": 605,
      "vol24h": 268266.678688,
      "time": 1791766991000,
      "amm": "rPZ4iweTw9ficJh4eRKFPSUPnZE7RZnykT",
      "spot": 0.7109419559328403,
      "tvl": 41207.414918,
      "lastTrade": 1791766991000
    },
    {
      "_id": "a81ca1d210d03dbf4c05f8d0a068e0d2",
      "currency": "5249504C00000000000000000000000000000000",
      "exch": 83889819.40614742,
      "firstSeen": 1790616372000,
      "firstTx": "62B3C3BB7FBFFAAB4F1F5F426A8CF13969683F4AB5E3881CD7AA755BAE2121D7",
      "holders": 638,
      "issuer": "rHxyYNNzCY6eK3xAMH9JzT4DxGUnZeG2fj",
      "name": "RIPL",
      "supply": 55099.203199999974,
      "trades24h": 96,
      "trustlines": 639,
      "vol24h": 194255.225076,
      "time": 1791766451000,
      "amm": "rf5BMXZaaCpwZHKAbTqfGXF2NHoHT1A1W8",
      "spot": 83874364.58850366,
      "tvl": 1586122.185814,
      "lastTrade": 1791766451000
    },
    {
      "_id": "a6dd9d54ecf08f220eb95f9a0b8cf2eb",
      "currency": "4645450000000000000000000000000000000000",
      "exch": 6496.618266841762,
      "firstSeen": 1790612661000,
      "firstTx": "5383535590E9B178091D48A27B289331CBCCF34856C427CA6CDDAE32A2DB87E0",
      "holders": 573,
      "issuer": "rBC6uXMVDPbWooecrt8KpX4UG1xVQHXRjC",
      "name": "FEE",
      "supply": 56870.90079487479,
      "trades24h": 66,
      "trustlines": 784,
      "vol24h": 112482.17999199999,
      "time": 1791766690000,
      "amm": "rE7v4y64DoHuwg3o3aCjuLYykTJWmHTWXJ",
      "spot": 6234.4617758656805,
      "tvl": 14101.380514,
      "lastTrade": 1791766462000
    },
    {
      "_id": "0a02103a756c1866ffae9e49c29786a4",
      "currency": "4445455000000000000000000000000000000000",
      "exch": 75.59443605347289,
      "firstSeen": 1790612512000,
      "firstTx": "392505969D9617B084A4CBA4239FCA79F4C420F99A67E943C05320097650E690",
      "holders": 595,
      "issuer": "rEZDNzhzWpVoAS8Tb8ftzp2jipj5s2douH",
      "name": "DEEP",
      "supply": 80304.35219999996,
      "trades24h": 955,
      "trustlines": 736,
      "vol24h": 107473.441259,
      "time": 1791766690000,
      "amm": "r3rWtUcwAMUvW8L6NvdgE2J4fX3n5Ka6Qn",
      "spot": 75.87702747490349,
      "tvl": 124424.190364,
      "lastTrade": 1791766671000
    }
  ],
  "count": 5,
  "total": 7636,
  "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}