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 response197 ms · just now · 2.8 KB · 118 lines
https://api.xrpl.to/v1/holders/list/0dd550278b74cb6690fdae351e8e0df3{ "success": true, "took": 195, "summary": { "top10Hold": 80.6, "top20Hold": 93.7, "top50Hold": 98.2, "top100Hold": 98.5, "gini": 0.9997, "hhi": 757, "frozen": 1 }, "length": 67474, "richList": [ { "account": "rEq4b7nbL2ep44Fgk9bPwpynGRjyESpf5B", "balance": 145750041.6700765, "freeze": false, "id": 1, "holding": 12.75, "isCreator": false, "rank": 1, "xrpBalance": 173111002.397992, "lastActive": 1791554990, "name": "Gemini", "domain": null, "funder": { "account": "raBQUYdAhnnojJQ6Xi3eXztZ74ot24RDq1", "name": "Gemini", "fundedCount": 11245, "fundedAt": 1761243532000, "amountXrp": 2.42 } }, { "account": "rDgBDkeTe5rbtRn2DJP8kHvQTuw28h8UVr", "balance": 132429854.6854558, "freeze": false, "balance24h": 135135173.4919542, "id": 2, "holding": 11.58, "isCreator": false, "rank": 2, "xrpBalance": 873.24944, "lastActive": 1791760121, "name": null, "domain": null, "funder": { "account": "rDAE53VfMvftPB4ogpWGWvzkQxfht6JPxr", "name": "Binance", "fundedCount": 180192, "fundedAt": 1642593811000, "amountXrp": 53.696 } }, { "account": "rDAE53VfMvftPB4ogpWGWvzkQxfht6JPxr", "balance": 122755999.1130347, "freeze": false, "balance24h": 122730641.8772106, "id": 3, "holding": 10.74, "isCreator": false, "rank": 3, "xrpBalance": 69219503.432771, "lastActive": 1791766721, "name": "Binance", "domain": null, "funder": { "account": "rJb5KsHsDHF1YS5B5DU6QCkH5NsPaKQTcy", "name": "Binance", "fundedCount": 638300, "fundedAt": 1637748341000, "amountXrp": 199.75 } }, { "account": "rKWoRYn65imVUUF2Hmtpp78E6NAjTf6ExL", "balance": 105000000.0000102, "freeze": false, "id": 4, "holding": 9.18, "isCreator": false, "rank": 4, "xrpBalance": 402863.652627, "lastActive": 1791578730, "name": null, "domain": null, "funder": { "account": "rsM7KAW1wutm2qxeF2FUWb9yRmSPjjS2Ex", "name": null, "fundedCount": 2, "fundedAt": 1783600322000, "amountXrp": 10 } }, { "account": "rMrjxnZGdsbfCuX3GKjFpAjwNw3XdWy9cu", "balance": 91000257, "freeze": false, "id": 5, "holding": 7.96, "isCreator": false, "rank": 5, "xrpBalance": 19.996206, "lastActive": 1791565192, "name": null, "domain": null, "funder": { "account": "rNGkoJhnzWTs9RtEnCSziqNLpxfx3ysf8J", "name": null, "fundedCount": 4, "fundedAt": 1736356211000, "amountXrp": 20 } } ] }
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 →