GET
/v1/holders/list/{id}
Paginated holder richlist with acquisition tracking
AuthNone — works without a key
Request
GET
https://api.xrpl.to/v1/holders/list/0dd550278b74cb6690fdae351e8e0df3| Path parameter | Value | Description |
|---|---|---|
| id | A token id: its md5, slug or issuer_currency |
| Query parameter | Value | Description |
|---|---|---|
| offset | int | |
| limit | int (default: 20, max 200) | |
| freeze | bool - only frozen trustlines | |
| sort | balance|value|holding|percent|change24h|pnl (value/percent are balance/holding aliases; default: balance desc) | |
| order | asc|desc | |
| search | account address (min 3 chars) | |
| minBalance | float - min balance (token units) | |
| maxBalance | float - max balance (token units) |
curl 'https://api.xrpl.to/v1/holders/list/0dd550278b74cb6690fdae351e8e0df3'
Response
200Example response167 ms · just now · 2.8 KB · 117 lines
https://api.xrpl.to/v1/holders/list/0dd550278b74cb6690fdae351e8e0df3{ "success": true, "took": 166, "summary": { "top10Hold": 83.9, "top20Hold": 92.2, "top50Hold": 97.5, "top100Hold": 98, "gini": 0.9997, "hhi": 1131, "frozen": 1 }, "length": 67887, "richList": [ { "account": "r39TAwuqkA5BNxxfL5YXewRGtCgBcADjcx", "balance": 135087702.5640507, "freeze": false, "balance24h": 130093452.5640507, "id": 1, "holding": 19.09, "isCreator": false, "rank": 1, "xrpBalance": 5868672.833921, "lastActive": 1793488611, "name": null, "domain": null, "funder": { "account": "rNGkoJhnzWTs9RtEnCSziqNLpxfx3ysf8J", "name": null, "fundedCount": 4, "fundedAt": 1743532350000, "amountXrp": 20 } }, { "account": "rDgBDkeTe5rbtRn2DJP8kHvQTuw28h8UVr", "balance": 131565977.6718009, "freeze": false, "id": 2, "holding": 18.59, "isCreator": false, "rank": 2, "xrpBalance": 873.00944, "lastActive": 1792048711, "name": null, "domain": null, "funder": { "account": "rDAE53VfMvftPB4ogpWGWvzkQxfht6JPxr", "name": "Binance", "fundedCount": 180632, "fundedAt": 1642593811000, "amountXrp": 53.696 } }, { "account": "rKWoRYn65imVUUF2Hmtpp78E6NAjTf6ExL", "balance": 105000000.0000102, "freeze": false, "id": 3, "holding": 14.84, "isCreator": false, "rank": 3, "xrpBalance": 90.602637, "lastActive": 1791908100, "name": null, "domain": null, "funder": { "account": "rsM7KAW1wutm2qxeF2FUWb9yRmSPjjS2Ex", "name": null, "fundedCount": 2, "fundedAt": 1783600322000, "amountXrp": 10 } }, { "account": "rMrjxnZGdsbfCuX3GKjFpAjwNw3XdWy9cu", "balance": 68411995.62, "freeze": false, "id": 4, "holding": 9.67, "isCreator": false, "rank": 4, "xrpBalance": 14.895501, "lastActive": 1793394340, "name": null, "domain": null, "funder": { "account": "rNGkoJhnzWTs9RtEnCSziqNLpxfx3ysf8J", "name": null, "fundedCount": 4, "fundedAt": 1736356211000, "amountXrp": 20 } }, { "account": "rs8ZPbYqgecRcDzQpJYAMhSxSi5htsjnza", "balance": 51172508, "freeze": false, "id": 5, "holding": 7.23, "isCreator": false, "rank": 5, "xrpBalance": 1603911721.334609, "lastActive": 1793397020, "name": "Binance", "domain": null, "funder": { "account": "rJb5KsHsDHF1YS5B5DU6QCkH5NsPaKQTcy", "name": "Binance", "fundedCount": 638294, "fundedAt": 1542267420000, "amountXrp": 22 } } ] }
Long arrays and strings are shortened in the example; Send request for the full answer.
Shapeas documented
{ success, took, summary: { top10Hold, top20Hold, top50Hold, top100Hold, frozen }, length (total holders; filtered count when search/minBalance/maxBalance set), richList[]: { account, balance, holding, rank, freeze, frozenByIssuer?, isCreator, xrpBalance, lastActive, name, domain, funder, tradedPct?, tradeCount?, source?, acquisition?, isAMM?, pnl? (realized+residual XRP), roi?, unrealized?, bought?/sold? (XRP volume), lastTrade? } }
What it does
Paginated holder richlist with acquisition tracking
A token id can be its md5, slug or issuer_currency. How to build an md5 →