/v1/holders/movers/{id}
Top 24h buyers and sellers by holder balance delta
Request
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
https://api.xrpl.to/v1/holders/movers/0dd550278b74cb6690fdae351e8e0df3{ "success": true, "took": 1904, "limit": 20, "pressure": { "m15": { "sellers": 22, "sellPressureXrp": 54174.7698183904, "buyers": 53, "buyPressureXrp": 955869.6889300004 }, "m30": { "sellers": 25, "sellPressureXrp": 62461.155317649354, "buyers": 59, "buyPressureXrp": 972393.0977240003 }, "h1": { "sellers": 30, "sellPressureXrp": 174297.96440382508, "buyers": 64, "buyPressureXrp": 1000751.6268650002 }, "h4": { "sellers": 62, "sellPressureXrp": 266604.9422997705, "buyers": 132, "buyPressureXrp": 1172889.6214040006 }, "h24": { "sellers": 186, "sellPressureXrp": 485835.4933582228, "buyers": 234, "buyPressureXrp": 1498182.4016830008 } }, "holders": 68205, "movers": 923, "buyersTotal": 504, "sellersTotal": 419, "boughtTotal": 68080311.50795518, "soldTotal": 46029152.69628709, "boughtTotalXrp": 72929746.90749794, "soldTotalXrp": 49307859.822505966, "buyers": [ { "account": "rPz2qA93PeRCyHyFCqyNggnyycJR1N4iNf", "balance": 71740275.576, "balance24h": 31608112.884, "change": 40132162.692, "holding": 9.33, "value": 76850414.23790309, "trades": [ [ 1795229680000, 1, 32059552.48, 852836999.23, 2 ], [ 1795239280000, 1, 3945439.87, 878845030.64, 2 ], [ 1795258461000, 1, 6394621.64, 857046257.49, 2 ], [ 1795267832000, 1, 2244594.06, 839003160.12, 2 ] ], "name": "Binance" }, { "account": "raRwevcTC4NafoNUP28JfmfrKYtdeQWwZ2", "balance": 21300000, "balance24h": 6300000, "change": 15000000, "holding": 2.77, "value": 22817222.40574929, "trades": [ [ 1795207930000, 1, 16941866.91, 868052793.93, 2 ] ], "name": null }, { "account": "rBNCyNEwpaEbGP9nqkQeYcvwYAwwKkRzTR", "balance": 36687874.42500948, "balance24h": 28964097.42500948, "change": 7723777, "holding": 4.77, "value": 39301192.035194494, "trades": [ [ 1795213700000, 1, 6741205.65, 842439249.92, 2 ], [ 1795252850000, 1, 4197159.33, 861842004.65, 2 ], [ 1795257132000, 1, 3068434.46, 862216088.54, 2 ], [ 1795257872000, -1, 5488726.96, 860159102.15, 2 ] ], "name": null }, { "account": "r39TAwuqkA5BNxxfL5YXewRGtCgBcADjcx", "balance": 56550138.6340507, "balance24h": 54015334.6840507, "change": 2534803.95, "holding": 7.35, "value": 60578267.14972255, "trades": [ [ 1795196440000, -1, 11092972.41, 852558258.14, 2 ], [ 1795196582000, 1, 11092972.41, 852558258.14, 2 ], [ 1795197690000, -1, 11034113.52, 848034616.01, 2 ], [ 1795197912000, 1, 11010324.19, 846206270.53, 2 ], [ 1795199000000, -1, 10955542.43, 841995979.48, 2 ] ], "name": null }, { "account": "rHCE7bhuPEiYcKxkWoHdxe3rTeuMsDxEDm", "balance": 1000306.0000102, "balance24h": 0.0000102, "change": 1000306, "holding": 0.13, "value": 1071558.895588647, "trades": [ [ 1795196941000, 1, 111.66, 849661763.68, 2 ], [ 1795204071000, 1, 113.83, 857675577.62, 2 ], [ 1795204091000, 1, 114.94, 857675577.62, 2 ], [ 1795207190000, 1, 1124918.98, 864564459.53, 2 ] ], "name": null } ], "sellers": [ { "account": "r9nsQj5fGr1TcDpCGqntaVWYqt53qS7mSN", "balance": 4485451.683166978, "balance24h": 35152200.22009376, "change": -30666748.536926784, "holding": 0.58, "value": 4804955.335448988, "trades": [ [ 1795196230000, 1, 17833.58, 852110944.35, 2 ], [ 1795198031000, 1, 2715.15, 846206270.53, 2 ], [ 1795198571000, 1, 18798.73, 846708257.66, 2 ], [ 1795201631000, 1, 18101.22, 853098368.18, 2 ], [ 1795202701000, 1, 7310.74, 857689212.97, 2 ] ], "name": null }, { "account": "ra8xqX4QhcogFfxpMxMByvFnXyxw9E8rzY", "balance": 7321913.99800072, "balance24h": 13800000.00000072, "change": -6478086.002, "holding": 0.95, "value": 7843461.977847483, "trades": [ [ 1795251851000, -1, 4212469.55, 864974240.63, 2 ], [ 1795256871000, -1, 3057083.94, 859010940.48, 2 ] ], "name": null }, { "account": "rDgBDkeTe5rbtRn2DJP8kHvQTuw28h8UVr", "balance": 7851092.99588623, "balance24h": 10899699.53951716, "change": -3048606.54363093, "holding": 1.02, "value": 8410334.97724679, "trades": [ [ 1795197321000, -1, 2721.96, 848331140.14, 2 ], [ 1795204261000, 1, 84399.33, 862094322.44, 2 ], [ 1795207801000, 1, 4524.94, 868052793.93, 2 ], [ 1795209680000, -1, 167860.83, 860070889.83, 2 ], [ 1795217330000, 1, 982742.48, 845741131.04, 2 ] ], "name": null }, { "account": "rEq4b7nbL2ep44Fgk9bPwpynGRjyESpf5B", "balance": 141650041.6700765, "balance24h": 144150041.6700765, "change": -2500000, "holding": 18.43, "value": 151739929.7920089, "trades": [ [ 1795197782000, -1, 2758528.38, 848034616.01, 2 ] ], "name": "Gemini" }, { "account": "rpr1MrBS6EPff1Tnnx4obsU7TcuEcwomNC", "balance": 76.61, "balance24h": 1000087.61, "change": -1000011, "holding": 0, "value": 82.06701448377714, "trades": [ [ 1795196941000, -1, 111.66, 849661763.68, 2 ], [ 1795201452000, -1, 114.07, 851124729.16, 2 ], [ 1795201822000, -1, 113.68, 856560069.83, 2 ], [ 1795204071000, -1, 113.83, 857675577.62, 2 ], [ 1795204091000, -1, 114.94, 857675577.62, 2 ] ], "name": null } ] }
Long arrays and strings are shortened in the example; Send request for the full answer.
{ 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