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 response35 ms · just now · 0.9 KB · 40 lines
https://api.xrpl.to/v1/testnet/tokens/ecfb8f46ab12687bf34adeda926a9adb/holders
{
  "success": true,
  "took": 34,
  "holders": [
    {
      "account": "rPZ4iweTw9ficJh4eRKFPSUPnZE7RZnykT",
      "balance": 29029.8912544681,
      "limit": 0,
      "time": 1791767060000
    },
    {
      "account": "rHt9t7QW5P3bHt6TXcABUXFoc9r3DLCRFm",
      "balance": 6857.808895842214,
      "limit": 1000000,
      "time": 1791735860000
    },
    {
      "account": "rJ3GhQeGAmaSvoY8kNS744RSwMLpHZVjgP",
      "balance": 6674.390804834986,
      "limit": 1000000,
      "time": 1791766592000
    },
    {
      "account": "rNJdBwBEmrdqmFxrgTcRjWoViaxHBSNUPX",
      "balance": 4561.148337831488,
      "limit": 647361,
      "time": 1791764111000
    },
    {
      "account": "rUCQpFahUejHT4ANXxBkbZNoDvpTFQexKb",
      "balance": 4546.212200979072,
      "limit": 1000000,
      "time": 1791756391000
    }
  ],
  "count": 50,
  "total": 605,
  "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