XRPL.to
GET /testnet/tokens/{md5}/holders
GET

/v1/testnet/tokens/{md5}/holders

Holders of a Testnet token, largest first

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/testnet/tokens/ecfb8f46ab12687bf34adeda926a9adb/holders
Path parameterValueDescription
md5The token's md5 (md5 of issuer_currency)
Query parameterValueDescription
limit1-200
pagefrom 1
curl 'https://api.xrpl.to/v1/testnet/tokens/ecfb8f46ab12687bf34adeda926a9adb/holders'

Response

200Example response27 ms · just now · 0.9 KB · 40 lines
https://api.xrpl.to/v1/testnet/tokens/ecfb8f46ab12687bf34adeda926a9adb/holders
{
  "success": true,
  "took": 25,
  "holders": [
    {
      "account": "rPZ4iweTw9ficJh4eRKFPSUPnZE7RZnykT",
      "balance": 41812.68778601498,
      "limit": 0,
      "time": 1792392462000
    },
    {
      "account": "rHt9t7QW5P3bHt6TXcABUXFoc9r3DLCRFm",
      "balance": 5596.042815782994,
      "limit": 1000000,
      "time": 1792382441000
    },
    {
      "account": "rwfdV61TzBHrJ1ae3LZZtEhGx1qHZU9udX",
      "balance": 5058.752760696336,
      "limit": 1000000,
      "time": 1792386561000
    },
    {
      "account": "rsQSJEa5avJM8X1hGgftQYckK6W2dsvZEc",
      "balance": 4793.738323397072,
      "limit": 1000000,
      "time": 1792388860000
    },
    {
      "account": "rpPgrQqQd2RY9RviSiHeBCTutinAHWLLHt",
      "balance": 4207.659313410267,
      "limit": 664646,
      "time": 1792363652000
    }
  ],
  "count": 50,
  "total": 608,
  "page": 1,
  "limit": 50
}

Long arrays and strings are shortened in the example; Send request for the full answer.

Shapeas documented
{
  holders: [{ account, balance, limit, time }],
  count,
  total
}

What it does

Holders of a Testnet token, largest first

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/tokens/{md5}NextGET/testnet/tokens/{md5}/offers