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 response1946 ms · just now · 8.2 KB · 433 lines
https://api.xrpl.to/v1/holders/movers/0dd550278b74cb6690fdae351e8e0df3{ "success": true, "took": 1944, "limit": 20, "pressure": { "m15": { "sellers": 27, "sellPressureXrp": 466697.2227861485, "buyers": 33, "buyPressureXrp": 317871.80016700015 }, "m30": { "sellers": 31, "sellPressureXrp": 466955.0234345966, "buyers": 40, "buyPressureXrp": 323256.6690490002 }, "h1": { "sellers": 34, "sellPressureXrp": 466981.0992592404, "buyers": 49, "buyPressureXrp": 326690.3025930003 }, "h4": { "sellers": 53, "sellPressureXrp": 523172.25663065456, "buyers": 72, "buyPressureXrp": 373385.62109600025 }, "h24": { "sellers": 134, "sellPressureXrp": 705975.5735802653, "buyers": 184, "buyPressureXrp": 634665.8272229994 } }, "holders": 67591, "movers": 798, "buyersTotal": 435, "sellersTotal": 363, "boughtTotal": 28857877.486987304, "soldTotal": 28902114.802264176, "boughtTotalXrp": 22012673.51556397, "soldTotalXrp": 22046417.562707905, "buyers": [ { "account": "rLoD9U2ghXP2xUYbtML6G6v1p8LhM9mSnc", "balance": 25225903.369559, "balance24h": 524903.369559, "change": 24701000, "holding": 2.47, "value": 19242218.18668613, "trades": [ [ 1792371061000, 1, 765.95, 781459937.37, 2 ], [ 1792371110000, 1, 6663803.27, 781459937.37, 2 ], [ 1792382012000, 1, 12238640, 780399497.03, 2 ] ], "name": null }, { "account": "rJWA8Q18Wrbu3t3gngEWpL8k5jAb3Jmpm1", "balance": 22181762.67341316, "balance24h": 18593945.08917518, "change": 3587817.58423798, "holding": 2.17, "value": 16920159.840228867, "trades": [ [ 1792365291000, 1, 2767405.76, 786948461.25, 2 ] ], "name": null }, { "account": "rhuCPEoLFYbpbwyhXioSumPKrnfCi3AXJZ", "balance": 1649431.648869, "balance24h": 1430898.176627, "change": 218533.472242, "holding": 0.16, "value": 1258179.8640306776, "trades": [ [ 1792313471000, -1, 22.15, 791309980.19, 2 ], [ 1792331912000, -1, 242.75, 796554541.5, 2 ], [ 1792374331000, 1, 34806.51, 779366419.59, 2 ], [ 1792384201000, -1, 34929.9, 777470491.89, 2 ], [ 1792391741000, 1, 22861.64, 777494196.34, 2 ] ], "name": "Coinone" }, { "account": "rDGJAj8DFMQsqGbiB4F2PhfxezrbpW2Mnh", "balance": 35115, "balance24h": 0, "change": 35115, "holding": 0, "value": 26785.58154, "trades": [ [ 1792326910000, 1, 3118969.45, 787595535.95, 2 ], [ 1792348881000, 1, 3690706.1, 801863827.17, 2 ], [ 1792371061000, -1, 765.95, 781459937.37, 2 ], [ 1792371110000, -1, 6663803.27, 781459937.37, 2 ], [ 1792371592000, 1, 6823984.64, 782261284.83, 2 ] ], "name": null }, { "account": "rGvKvNzPRpWSJSXMYXTQ3YVBtE6Zs6n8ro", "balance": 60006.83140767932, "balance24h": 30001.23439768704, "change": 30005.59700999228, "holding": 0, "value": 45772.97097045215, "pnl": -13439.00504867286, "roi": -0.5034488592120757, "lastTrade": 1792365700000, "breakevenMcap": 795445585.0810393, "trades": [ [ 1792333820000, -1, 23571.24, 801763003.43, 0 ], [ 1792358310000, 1, 23633.26, 803722649.41, 0 ], [ 1792365700000, 1, 23034.36, 783355069.5, 0 ] ], "name": null } ], "sellers": [ { "account": "rBNCyNEwpaEbGP9nqkQeYcvwYAwwKkRzTR", "balance": 10634115.11441248, "balance24h": 26634115.51441248, "change": -16000000.4, "holding": 1.04, "value": 8111660.472813382, "trades": [ [ 1792324082000, 1, 3119667.62, 787771875.63, 2 ], [ 1792326910000, -1, 3118969.45, 787595535.95, 2 ], [ 1792347471000, 1, 3691410.97, 802017004.58, 2 ], [ 1792348881000, -1, 3690706.1, 801863827.17, 2 ], [ 1792371592000, -1, 6823984.64, 782261284.83, 2 ] ], "name": null }, { "account": "rDAE53VfMvftPB4ogpWGWvzkQxfht6JPxr", "balance": 25092450.29436116, "balance24h": 33924663.41889539, "change": -8832213.12453423, "holding": 2.45, "value": 19140420.714737516, "trades": [ [ 1792313972000, -1, 6.21, 790764149.96, 2 ], [ 1792313982000, -1, 6.2, 790764149.96, 2 ], [ 1792314400000, 1, 1084.73, 785793944.37, 2 ], [ 1792316522000, -1, 6.16, 784554228.09, 2 ], [ 1792322271000, -1, 47.63, 786259268.22, 2 ] ], "name": "Binance" }, { "account": "rMvCasZ9cohYrSZRNYPTZfoaaSUQMfgQ8G", "balance": 14508641.04649082, "balance24h": 18142162.11815768, "change": -3633521.07166686, "holding": 1.42, "value": 11067133.355699012, "trades": [ [ 1792314002000, 1, 48.81, 789716423.28, 2 ], [ 1792335632000, 1, 7045.53, 798345946.23, 2 ], [ 1792342622000, -1, 7874.6, 803400552.14, 2 ], [ 1792342802000, 1, 7844.67, 800363351.87, 2 ], [ 1792365291000, -1, 2767405.76, 786948461.25, 2 ] ], "name": "Bybit" }, { "account": "rMrjxnZGdsbfCuX3GKjFpAjwNw3XdWy9cu", "balance": 13036868, "balance24h": 13136868, "change": -100000, "holding": 1.27, "value": 9944470.762928, "trades": [ [ 1792373912000, -1, 76435.38, 779826975.22, 2 ] ], "name": null }, { "account": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns", "balance": 520121.2003653334, "balance24h": 588560.1155958077, "change": -68438.9152304743, "holding": 0.05, "value": 396746.3711538749, "pnl": 2614973.5199182774, "roi": -0.4657350009871294, "lastTrade": 1792398062000, "breakevenMcap": 795476503.5141153, "trades": [ [ 1792312591000, 1, 0.15, 790929292.18, 2 ], [ 1792312682000, 1, 0.7, 790929292.18, 2 ], [ 1792312700000, 1, 0.09, 790929292.18, 2 ], [ 1792312771000, 1, 0.36, 790929292.18, 2 ], [ 1792312802000, -1, 0.78, 791746644.37, 2 ] ], "name": null } ] }
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 →