GET
/v1/traders/token-traders/{id}
Top traders for a token
AuthNone — works without a key
Request
GET
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
200Example response271 ms · just now · 5.7 KB · 173 lines
https://api.xrpl.to/v1/traders/token-traders/0dd550278b74cb6690fdae351e8e0df3{ "success": true, "tokenId": "0dd550278b74cb6690fdae351e8e0df3", "interval": "all", "traders": [ { "address": "rfmdBKhtJw2J22rw1JxQcchQTM68qzE4N2", "volume": 663424797.5705774, "trades": 1854247, "profit": 15765987.035688747, "roi": -0.018855239991604378, "xrpBought": 323743029.7983104, "xrpSold": 339681767.772267, "volumeAll": 663424797.5705774, "tradesAll": 1854247, "profitAll": 15765987.035688747, "roiAll": -0.018855239991604378, "xrpBoughtAll": 323743029.7983104, "xrpSoldAll": 339681767.772267, "tokensBought": 696490437.4689507, "tokensSold": 735094252.8458827, "buyCount": 841613, "sellCount": 1012634, "avgBuyPrice": 0.464820494843828, "avgSellPrice": 0.462092808448994, "avgBuyMcap": 531184678.7862355, "avgSellMcap": 528067550.2655658, "lastTradeDate": 1774018641000, "firstTradeDate": 1734440410000, "washTradingScore": 100, "suspiciousActivity": true, "actualBalance": 0.001010201, "unrealizedPnl": 0.00001734219342381662, "holdingValue": 0.0007171668376526809, "totalPnl": 15765987.03570609, "totalRoi": -0.018855239991604378 }, { "address": "rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ", "volume": 393414922.26416135, "trades": 1203913, "profit": 193456.60775281675, "roi": -0.2400953318907713, "xrpBought": 196621363.00791407, "xrpSold": 196793559.25624728, "volumeAll": 393414922.26416135, "tradesAll": 1203913, "profitAll": 193456.60775281675, "roiAll": -0.2400953318907713, "xrpBoughtAll": 196621363.00791407, "xrpSoldAll": 196793559.25624728, "tokensBought": 327606096.292626, "tokensSold": 328432669.526304, "buyCount": 603051, "sellCount": 600862, "avgBuyPrice": 0.600176142120038, "avgSellPrice": 0.599189963471299, "avgBuyMcap": 685865564.8871666, "avgSellMcap": 684738585.7746552, "lastTradeDate": 1791765970000, "firstTradeDate": 1734541501000, "washTradingScore": 60, "suspiciousActivity": true, "actualBalance": 29425.50808857833, "unrealizedPnl": -370.45871066147083, "holdingValue": 20889.900705116215, "totalPnl": 193086.14904215527, "totalRoi": -0.2400953318907713 }, { "address": "rm9oxnf2QRUckx5YDVYHMCN1stbu1ngjW", "volume": 187245155.32833722, "trades": 517762, "profit": 3195775.8507873164, "roi": -1.0323670294349492, "xrpBought": 92099623.2185656, "xrpSold": 95145532.10977162, "volumeAll": 187245155.32833722, "tradesAll": 517762, "profitAll": 3195775.8507873164, "roiAll": -1.0323670294349492, "xrpBoughtAll": 92099623.2185656, "xrpSoldAll": 95145532.10977162, "tokensBought": 114884357.83374846, "tokensSold": 119243339.82190919, "buyCount": 206966, "sellCount": 310796, "avgBuyPrice": 0.801672437877751, "avgSellPrice": 0.797910661106565, "avgBuyMcap": 916130250.5582191, "avgSellMcap": 911831390.6584649, "lastTradeDate": 1785853861000, "firstTradeDate": 1774020211000, "washTradingScore": 100, "suspiciousActivity": true, "actualBalance": 0, "unrealizedPnl": 0, "holdingValue": 0, "totalPnl": 3195775.8507873164, "totalRoi": -1.0323670294349492 }, { "address": "rnUdnfhAZEbULVvR5sZEssrTYYvS9xE2sv", "volume": 165676985.8913705, "trades": 374955, "profit": 174118.38484442967, "roi": 0.007231849602261573, "xrpBought": 82751517.40485965, "xrpSold": 82925468.48651086, "volumeAll": 165676985.8913705, "tradesAll": 374955, "profitAll": 174118.38484442967, "roiAll": 0.007231849602261573, "xrpBoughtAll": 82751517.40485965, "xrpSoldAll": 82925468.48651086, "tokensBought": 158645470.310864, "tokensSold": 158805784.939062, "buyCount": 184942, "sellCount": 190013, "avgBuyPrice": 0.521612859432475, "avgSellPrice": 0.522181660563131, "avgBuyMcap": 596085504.5376192, "avgSellMcap": 596735515.5617292, "lastTradeDate": 1791766551000, "firstTradeDate": 1755206511000, "washTradingScore": 0, "suspiciousActivity": false, "actualBalance": 235.0264814079947, "unrealizedPnl": -0.45204357504732684, "holdingValue": 166.85114985632381, "totalPnl": 174117.9328008546, "totalRoi": 0.007231849602261573 }, { "address": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns", "volume": 82952730.03884275, "trades": 340134, "profit": 2804686.3394925673, "roi": -0.09487397234041613, "xrpBought": 40317846.66374581, "xrpSold": 42634883.37509694, "volumeAll": 82952730.03884275, "tradesAll": 340134, "profitAll": 2804686.3394925673, "roiAll": -0.09487397234041613, "xrpBoughtAll": 40317846.66374581, "xrpSoldAll": 42634883.37509694, "tokensBought": 51819221.3266432, "tokensSold": 54686817.7712582, "buyCount": 149674, "sellCount": 190460, "avgBuyPrice": 0.778048099364553, "avgSellPrice": 0.779619021780137, "avgBuyMcap": 889132975.6878703, "avgSellMcap": 890928184.6512797, "lastTradeDate": 1791766691000, "firstTradeDate": 1785151650000, "washTradingScore": 100, "suspiciousActivity": true, "actualBalance": 313851.7524131995, "unrealizedPnl": -1918.2670866840344, "holdingValue": 222811.17200431047, "totalPnl": 2802768.072405883, "totalRoi": -0.09487397234041613 } ], "count": 50, "total": 45983, "offset": 0, "sortBy": "volume", "limit": 50, "responseTime": "270ms" }
Long arrays and strings are shortened in the example; Send request for the full answer.
Shapeas documented
{ success, tokenId, interval, traders[], count (rows in this response), total (matching traders), offset, sortBy, limit }
What it does
Top traders for a token
A token id can be its md5, slug or issuer_currency. How to build an md5 →