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/2b5e3c50d0500edf86212000b9883dce/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/2b5e3c50d0500edf86212000b9883dce/holders'

Response

200Example response3 ms · just now · 0.8 KB · 40 lines
https://api.xrpl.to/v1/testnet/tokens/2b5e3c50d0500edf86212000b9883dce/holders
{
  "success": true,
  "took": 1,
  "holders": [
    {
      "account": "rHh8QTC8Jr8dEwzUWTQxdFF3ZBhKGp1gAk",
      "balance": 25059.39213945941,
      "limit": 0,
      "time": 1793516762000
    },
    {
      "account": "rp5xSm78RgLUnLj8NFs4jw8DtANMPC84cV",
      "balance": 1552.503314245225,
      "limit": 1000000,
      "time": 1793516762000
    },
    {
      "account": "r4iJmozmoKoArBRNJm4u1eRvmb1SYMBF1B",
      "balance": 1324.3689,
      "limit": 0,
      "time": 1793417430000
    },
    {
      "account": "rQHiCsu9meFXm8tUADeaucaKGdnn5S4Nbj",
      "balance": 1280.646161689045,
      "limit": 1000000,
      "time": 1793516731000
    },
    {
      "account": "rM75HMR8FZkNpt9zbVT4LvJL2MHrmjzpaz",
      "balance": 835.9011,
      "limit": 0,
      "time": 1793417450000
    }
  ],
  "count": 28,
  "total": 28,
  "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