GET
/v1/holders/movers/{id}
Top 24h buyers and sellers by holder balance delta
AuthNone — works without a key
Request
GET
https://api.xrpl.to/v1/holders/movers/0dd550278b74cb6690fdae351e8e0df3| Path parameter | Value | Description |
|---|---|---|
| id | A token id: its md5, slug or issuer_currency |
| Query parameter | Value | Description |
|---|---|---|
| limit | int per side (default: 20, max 50) |
curl 'https://api.xrpl.to/v1/holders/movers/0dd550278b74cb6690fdae351e8e0df3'
Response
200Example response1848 ms · just now · 8.3 KB · 443 lines
https://api.xrpl.to/v1/holders/movers/0dd550278b74cb6690fdae351e8e0df3{ "success": true, "took": 1846, "limit": 20, "pressure": { "m15": { "sellers": 8, "sellPressureXrp": 23204.93825437609, "buyers": 8, "buyPressureXrp": 603651.588498 }, "m30": { "sellers": 18, "sellPressureXrp": 32563.889840640924, "buyers": 15, "buyPressureXrp": 613112.547686 }, "h1": { "sellers": 20, "sellPressureXrp": 57469.55051014473, "buyers": 25, "buyPressureXrp": 615318.5901659998 }, "h4": { "sellers": 28, "sellPressureXrp": 63619.27440854693, "buyers": 49, "buyPressureXrp": 631209.7452089998 }, "h24": { "sellers": 75, "sellPressureXrp": 162933.82235978177, "buyers": 125, "buyPressureXrp": 922918.4072179995 } }, "holders": 67887, "movers": 609, "buyersTotal": 352, "sellersTotal": 257, "boughtTotal": 16813479.592745528, "soldTotal": 667858.7188692768, "boughtTotalXrp": 13418603.11456761, "soldTotalXrp": 533008.7109974016, "buyers": [ { "account": "r39TAwuqkA5BNxxfL5YXewRGtCgBcADjcx", "balance": 135087702.5640507, "balance24h": 130093452.5640507, "change": 4994250, "holding": 19.09, "value": 107811607.72621211, "trades": [ [ 1793445721000, 1, 3999888.96, 566522279.14, 2 ], [ 1793484850000, -1, 0.83, 564418725.22, 2 ], [ 1793484942000, 1, 0.83, 564706727.2, 2 ], [ 1793485101000, -1, 0.81, 564706727.2, 2 ], [ 1793485161000, 1, 0.81, 564706727.2, 2 ] ], "name": null }, { "account": "rDGJAj8DFMQsqGbiB4F2PhfxezrbpW2Mnh", "balance": 5029328.022, "balance24h": 100100.006, "change": 4929228.016, "holding": 0.71, "value": 4013836.415474023, "trades": [ [ 1793436570000, 1, 3378890.58, 568569701.28, 2 ], [ 1793436802000, -1, 3374106.92, 567771503, 2 ], [ 1793439550000, 1, 3935622.75, 567121181.53, 2 ], [ 1793445671000, -1, 3931426.52, 566522279.14, 2 ], [ 1793452051000, 1, 3951584.93, 567075077.78, 2 ] ], "name": null }, { "account": "rBNCyNEwpaEbGP9nqkQeYcvwYAwwKkRzTR", "balance": 7864135.21525048, "balance24h": 3680864.21525048, "change": 4183271, "holding": 1.11, "value": 6276256.423344507, "trades": [ [ 1793436802000, 1, 3374106.92, 567771503, 2 ], [ 1793445671000, 1, 3931426.52, 566522279.14, 2 ], [ 1793452051000, -1, 3951584.93, 567075077.78, 2 ] ], "name": null }, { "account": "rLoD9U2ghXP2xUYbtML6G6v1p8LhM9mSnc", "balance": 2033785.534559, "balance24h": 140584.558559, "change": 1893200.976, "holding": 0.28, "value": 1623135.8153948658, "trades": [ [ 1793431500000, 1, 12824004.05, 566947704.19, 2 ], [ 1793436570000, -1, 3378890.58, 568569701.28, 2 ], [ 1793439550000, -1, 3935622.75, 567121181.53, 2 ], [ 1793445580000, -1, 4003994.24, 567098049.91, 2 ] ], "name": null }, { "account": "rMvCasZ9cohYrSZRNYPTZfoaaSUQMfgQ8G", "balance": 25470005.79758266, "balance24h": 25082906.87517157, "change": 387098.92241109, "holding": 3.6, "value": 20327255.713978518, "trades": [ [ 1793435100000, -1, 65.05, 568252954.51, 2 ], [ 1793440170000, -1, 91.45, 567690604.81, 2 ], [ 1793440571000, -1, 25402.78, 566956991.74, 2 ], [ 1793440892000, -1, 29527.29, 567571981.97, 2 ], [ 1793442101000, -1, 98.54, 567660895.77, 2 ] ], "name": "Bybit" } ], "sellers": [ { "account": "rJWA8Q18Wrbu3t3gngEWpL8k5jAb3Jmpm1", "balance": 16626034.97414643, "balance24h": 17065072.16438592, "change": -439037.19023949, "holding": 2.35, "value": 13269006.183779527, "trades": [ [ 1793431801000, 1, 100.21, 568420278.19, 2 ], [ 1793434802000, 1, 29530.89, 567639623.08, 2 ], [ 1793488610000, -1, 380539.35, 565544886.56, 2 ] ], "name": null }, { "account": "rpFnSsTz448J6qTiXWcFhDLVmQxsMNRnWH", "balance": 438147.9, "balance24h": 500636.9, "change": -62489, "holding": 0.06, "value": 349679.716393625, "trades": [ [ 1793507620000, -1, 49932.6, 565223140.21, 2 ] ], "name": null }, { "account": "rMdG3ju8pgyVh29ELPWaDuA74CpWW6Fxns", "balance": 36573.05043024067, "balance24h": 81362.77304249245, "change": -44789.72261225178, "holding": 0, "value": 29188.44048344475, "trades": [ [ 1793430440000, 1, 2406.08, 567320856.71, 2 ], [ 1793445110000, 1, 137.88, 567405893.17, 2 ], [ 1793447551000, 1, 12.01, 566113385.07, 2 ], [ 1793447831000, -1, 399.93, 566922965.42, 2 ], [ 1793449730000, 1, 90.57, 566975112.08, 2 ] ], "name": "Uphold" }, { "account": "rDi2VysuPsU5oQRGPDTPiR9YPd34kzK9m8", "balance": 8716.094345249261, "balance24h": 29545.47224918154, "change": -20829.37790393228, "holding": 0, "value": 6956.193099879835, "pnl": 18485.35976888347, "roi": 0.04911525110824254, "lastTrade": 1793514881000, "breakevenMcap": 564669499.8398105, "trades": [ [ 1793431121000, -1, 12.1, 566349636.1, 0 ], [ 1793431940000, 1, 6.05, 568420278.19, 0 ], [ 1793432890000, 1, 6.06, 568068744.05, 0 ], [ 1793433642000, 1, 0, 568297582.23, 0 ], [ 1793433701000, -1, 44.64, 568297582.23, 0 ] ], "name": null }, { "account": "rGDreBvnHrX1get7na3J4oowN19ny4GzFn", "balance": 4104676.444234474, "balance24h": 4123890.243247474, "change": -19213.799013, "holding": 0.58, "value": 3275884.912166654, "trades": [ [ 1793462062000, -1, 80.31, 564802026.84, 2 ], [ 1793466561000, 1, 599.37, 565294058.23, 2 ], [ 1793494990000, -1, 15947.5, 563708912.94, 2 ], [ 1793500070000, 1, 118.53, 565932112.55, 2 ] ], "name": "Bitget" } ] }
Long arrays and strings are shortened in the example; Send request for the full answer.
Shapeas documented
{ success, took, limit, holders (total), movers (holders with a 24h change), buyersTotal, sellersTotal, boughtTotal/soldTotal (token-unit sums over all movers) + boughtTotalXrp/soldTotalXrp, pressure?: { m15/m30/h1/h4/h24: { sellers, sellPressureXrp (holdings value of recently-active sellers), buyers, buyPressureXrp (XRP balances of recently-active buyers) } }, buyers[]/sellers[] (capped at limit): { account, name, balance, balance24h, change (token delta, signed), holding (% of supply), value? (current holdings worth, XRP), pnl?/roi? (trading gain/loss XRP + %), lastTrade? (last trade of this token), breakevenMcap? (entry breakeven: mcap XRP where their held tokens equal their FIFO cost), trades? (24h balance-change events [ timeMs, side, xrpValue, mcapAtEvent, kind ] from trusts_24h + hourly candles; side 1=received/-1=sent, kind 0=trade/1=LP/2=transfer, max 120), isAMM?, isCreator?, freeze? } }
What it does
Top 24h buyers and sellers by holder balance delta
A token id can be its md5, slug or issuer_currency. How to build an md5 →