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/12989284778980e987410b6e10cf7f9c/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/12989284778980e987410b6e10cf7f9c/holders'

Response

200Example response3 ms · just now · 0.9 KB · 40 lines
https://api.xrpl.to/v1/testnet/tokens/12989284778980e987410b6e10cf7f9c/holders
{
  "success": true,
  "took": 1,
  "holders": [
    {
      "account": "rEc17YM54zCGkzHfnNGtrp1dR31ACUYhep",
      "balance": 27814.59723541317,
      "limit": 0,
      "time": 1789975862000
    },
    {
      "account": "r9n8QuXGjp2RfLuE3GZkot5bnyGcucQfmr",
      "balance": 3065.672477402276,
      "limit": 1000000,
      "time": 1789974702000
    },
    {
      "account": "rhPpe9bR7JeY5wjD36QConkYHogcz8YVeT",
      "balance": 2495.040887265047,
      "limit": 1000000,
      "time": 1789974602000
    },
    {
      "account": "rGfkYo8GAoQ5eLgxoYTfcKpRcmnnd5qsua",
      "balance": 2078.506990363233,
      "limit": 1000000,
      "time": 1789974980000
    },
    {
      "account": "rEMYW7dJsVenxF13i2aGuym7YjYYMnZ5mY",
      "balance": 2042.420031460737,
      "limit": 1000000,
      "time": 1789973421000
    }
  ],
  "count": 50,
  "total": 119,
  "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. 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