/v1/traders/token-traders/{id}
Top traders for a token
Request
https://api.xrpl.to/v1/traders/token-traders/0dd550278b74cb6690fdae351e8e0df3| Path parameter | Value | Description |
|---|---|---|
| id | A token id: its md5, slug or issuer_currency |
| Query parameter | Value | Description |
|---|---|---|
| interval | 24h|7d|30d|all | |
| sortBy | volume|pnl|trades|bought|sold|roi|wash|lastActive|unrealized|balance | |
| limit | int (max 500, default 50) | |
| offset | int | |
| minVolume | float (filters all-time buyVolume) | |
| search | address prefix |
curl 'https://api.xrpl.to/v1/traders/token-traders/0dd550278b74cb6690fdae351e8e0df3'
Response
https://api.xrpl.to/v1/traders/token-traders/0dd550278b74cb6690fdae351e8e0df3{ "success": true, "tokenId": "0dd550278b74cb6690fdae351e8e0df3", "interval": "all", "traders": [ { "address": "rfmdBKhtJw2J22rw1JxQcchQTM68qzE4N2", "volume": 663427095.0140126, "trades": 1854265, "profit": 15771439.33745231, "roi": -0.01871676544831235, "xrpBought": 323743210.0345455, "xrpSold": 339683884.97946703, "volumeAll": 663427095.0140126, "tradesAll": 1854265, "profitAll": 15771439.33745231, "roiAll": -0.01871676544831235, "xrpBoughtAll": 323743210.0345455, "xrpSoldAll": 339683884.97946703, "tokensBought": 696490788.269817, "tokensSold": 735098314.663384, "buyCount": 841615, "sellCount": 1012650, "avgBuyPrice": 0.46482051950575, "avgSellPrice": 0.46209313530397, "avgBuyMcap": 357241105.1239206, "avgSellMcap": 355144954.66271156, "lastTradeDate": 1774018641000, "firstTradeDate": 1734440410000, "washTradingScore": 100, "suspiciousActivity": true, "actualBalance": 0.001010201, "unrealizedPnl": 0.00038233784947676796, "holdingValue": 0.0010821587273009549, "totalPnl": 15771439.337834647, "totalRoi": -0.01871676544831235 }, { "address": "rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ", "volume": 450026214.5322435, "trades": 1353558, "profit": 186863.55727025727, "roi": -0.21436141661418398, "xrpBought": 224971029.14864686, "xrpSold": 225055185.3835966, "volumeAll": 450026214.5322435, "tradesAll": 1353558, "profitAll": 186863.55727025727, "roiAll": -0.21436141661418398, "xrpBoughtAll": 224971029.14864686, "xrpSoldAll": 225055185.3835966, "tokensBought": 358654874.784307, "tokensSold": 359419751.232375, "buyCount": 655797, "sellCount": 697761, "avgBuyPrice": 0.627263268856845, "avgSellPrice": 0.626162542853946, "avgBuyMcap": 482087631.6052787, "avgSellMcap": 481241660.8333076, "lastTradeDate": 1795234590000, "firstTradeDate": 1734541501000, "washTradingScore": 60, "suspiciousActivity": true, "actualBalance": 91506.01196476084, "unrealizedPnl": -4683.236568744178, "holdingValue": 98024.08574944148, "totalPnl": 182180.3207015131, "totalRoi": -0.21436141661418398 }, { "address": "rm9oxnf2QRUckx5YDVYHMCN1stbu1ngjW", "volume": 187245148.23381442, "trades": 517762, "profit": 3181924.1949452534, "roi": -1.0468787129649189, "xrpBought": 92099622.66986609, "xrpSold": 95145525.56394835, "volumeAll": 187245148.23381442, "tradesAll": 517762, "profitAll": 3181924.1949452534, "roiAll": -1.0468787129649189, "xrpBoughtAll": 92099622.66986609, "xrpSoldAll": 95145525.56394835, "tokensBought": 114884357.237627, "tokensSold": 119243332.660265, "buyCount": 206966, "sellCount": 310796, "avgBuyPrice": 0.801672437261122, "avgSellPrice": 0.797910654132975, "avgBuyMcap": 616131034.2733426, "avgSellMcap": 613239889.1849874, "lastTradeDate": 1785853861000, "firstTradeDate": 1774020211000, "washTradingScore": 100, "suspiciousActivity": true, "actualBalance": 0, "unrealizedPnl": 0, "holdingValue": 0, "totalPnl": 3181924.1949452534, "totalRoi": -1.0468787129649189 }, { "address": "rnUdnfhAZEbULVvR5sZEssrTYYvS9xE2sv", "volume": 166675447.13709885, "trades": 379582, "profit": 174800.0119179958, "roi": 0.007976100163557152, "xrpBought": 83250973.2619738, "xrpSold": 83424473.87512505, "volumeAll": 166675447.13709885, "tradesAll": 379582, "profitAll": 174800.0119179958, "roiAll": 0.007976100163557152, "xrpBoughtAll": 83250973.2619738, "xrpSoldAll": 83424473.87512505, "tokensBought": 159197325.92385, "tokensSold": 159356693.538433, "buyCount": 187714, "sellCount": 191868, "avgBuyPrice": 0.5229420329698, "avgSellPrice": 0.523507811455721, "avgBuyMcap": 401910806.288254, "avgSellMcap": 402345639.3541021, "lastTradeDate": 1795280631000, "firstTradeDate": 1755206511000, "washTradingScore": 0, "suspiciousActivity": false, "actualBalance": 1205.850826060207, "unrealizedPnl": -7.65386153346526, "holdingValue": 1291.7449054634858, "totalPnl": 174792.35805646234, "totalRoi": 0.007976100163557152 }, { "address": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns", "volume": 141787540.6214226, "trades": 438382, "profit": 4499212.318899687, "roi": 1.3046114213019908, "xrpBought": 69052776.90233016, "xrpSold": 72734763.71909241, "volumeAll": 141787540.6214226, "tradesAll": 438382, "profitAll": 4499212.318899687, "roiAll": 1.3046114213019908, "xrpBoughtAll": 69052776.90233016, "xrpSoldAll": 72734763.71909241, "tokensBought": 86207232.1225439, "tokensSold": 90428494.776632, "buyCount": 195188, "sellCount": 243194, "avgBuyPrice": 0.801009094041801, "avgSellPrice": 0.804334561785586, "avgBuyMcap": 615621217.1400571, "avgSellMcap": 618177028.9469603, "lastTradeDate": 1795282232000, "firstTradeDate": 1785151650000, "washTradingScore": 100, "suspiciousActivity": true, "actualBalance": 363674.3044511284, "unrealizedPnl": -5038.500383608742, "holdingValue": 224626.91473468926, "totalPnl": 4494173.818516078, "totalRoi": 1.3046114213019908 } ], "count": 50, "total": 47667, "offset": 0, "sortBy": "volume", "limit": 50, "responseTime": "196ms" }
Long arrays and strings are shortened in the example; Send request for the full answer.
{ success, tokenId, interval, traders[], count (rows in this response), total (matching traders), offset, sortBy, limit }
What it does
Top traders for a token