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.9 KB · 40 lines
https://api.xrpl.to/v1/testnet/tokens/2b5e3c50d0500edf86212000b9883dce/holders
{
  "success": true,
  "took": 2,
  "holders": [
    {
      "account": "rHh8QTC8Jr8dEwzUWTQxdFF3ZBhKGp1gAk",
      "balance": 21730.01804448296,
      "limit": 0,
      "time": 1795282251000
    },
    {
      "account": "r4iJmozmoKoArBRNJm4u1eRvmb1SYMBF1B",
      "balance": 1353.167477315014,
      "limit": 0,
      "time": 1795130312000
    },
    {
      "account": "rM75HMR8FZkNpt9zbVT4LvJL2MHrmjzpaz",
      "balance": 795.4677310837915,
      "limit": 0,
      "time": 1795130301000
    },
    {
      "account": "rBmop6doQD5nskxpwmgmLscCZNwsauTuNg",
      "balance": 181.1974998883496,
      "limit": 794051,
      "time": 1795279960000
    },
    {
      "account": "rM1EKHCJbCG8W2aC9ikhWnGt3Gi5y5ooCu",
      "balance": 168.1321970062123,
      "limit": 377177,
      "time": 1795281950000
    }
  ],
  "count": 30,
  "total": 30,
  "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