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 response393 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": 663427095.0140126, "trades": 1854265, "profit": 15771439.33745231, "roi": -0.0187167655333356, "xrpBought": 323743210.0345455, "xrpSold": 339683884.97946703, "volumeAll": 663427095.0140126, "tradesAll": 1854265, "profitAll": 15771439.33745231, "roiAll": -0.0187167655333356, "xrpBoughtAll": 323743210.0345455, "xrpSoldAll": 339683884.97946703, "tokensBought": 696490788.269817, "tokensSold": 735098314.663384, "buyCount": 841615, "sellCount": 1012650, "avgBuyPrice": 0.46482051950575, "avgSellPrice": 0.46209313530397, "avgBuyMcap": 328794564.13968116, "avgSellMcap": 326865326.8056253, "lastTradeDate": 1774018641000, "firstTradeDate": 1734440410000, "washTradingScore": 100, "suspiciousActivity": true, "actualBalance": 0.001010201, "unrealizedPnl": 0.00010640642391697484, "holdingValue": 0.0008062273017411618, "totalPnl": 15771439.337558717, "totalRoi": -0.0187167655333356 }, { "address": "rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ", "volume": 409764893.44802946, "trades": 1257306, "profit": 187600.5826469512, "roi": -0.23310379653744134, "xrpBought": 204797798.50729808, "xrpSold": 204967094.94073138, "volumeAll": 409764893.44802946, "tradesAll": 1257306, "profitAll": 187600.5826469512, "roiAll": -0.23310379653744134, "xrpBoughtAll": 204797798.50729808, "xrpSoldAll": 204967094.94073138, "tokensBought": 338326144.908399, "tokensSold": 339159534.782001, "buyCount": 622969, "sellCount": 634337, "avgBuyPrice": 0.605326551286028, "avgSellPrice": 0.604338294874936, "avgBuyMcap": 428182645.2151794, "avgSellMcap": 427483594.0280916, "lastTradeDate": 1793516192000, "firstTradeDate": 1734541501000, "washTradingScore": 60, "suspiciousActivity": true, "actualBalance": 22992.5862126879, "unrealizedPnl": 45.91254839796602, "holdingValue": 18350.06176226949, "totalPnl": 187646.49519534915, "totalRoi": -0.23310379653744134 }, { "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": 567069500.0133398, "avgSellMcap": 564408572.2098033, "lastTradeDate": 1785853861000, "firstTradeDate": 1774020211000, "washTradingScore": 100, "suspiciousActivity": true, "actualBalance": 0, "unrealizedPnl": 0, "holdingValue": 0, "totalPnl": 3181924.1949452534, "totalRoi": -1.0468787129649189 }, { "address": "rnUdnfhAZEbULVvR5sZEssrTYYvS9xE2sv", "volume": 165996282.79231593, "trades": 376813, "profit": 174235.79843723585, "roi": 0.00736664426170741, "xrpBought": 82911413.71144082, "xrpSold": 83084869.08087511, "volumeAll": 165996282.79231593, "tradesAll": 376813, "profitAll": 174235.79843723585, "roiAll": 0.00736664426170741, "xrpBoughtAll": 82911413.71144082, "xrpSoldAll": 83084869.08087511, "tokensBought": 158855197.617394, "tokensSold": 159014765.494848, "buyCount": 185979, "sellCount": 190834, "avgBuyPrice": 0.52193075804252, "avgSellPrice": 0.522497824792044, "avgBuyMcap": 369191954.52936727, "avgSellMcap": 369593073.79352134, "lastTradeDate": 1793381122000, "firstTradeDate": 1755206511000, "washTradingScore": 0, "suspiciousActivity": false, "actualBalance": 1005.587951410644, "unrealizedPnl": 22.116688886410316, "holdingValue": 802.5456921238704, "totalPnl": 174257.91512612227, "totalRoi": 0.00736664426170741 }, { "address": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns", "volume": 118042144.47067384, "trades": 417846, "profit": 2511974.592434152, "roi": -0.5639948599211692, "xrpBought": 58090978.20906269, "xrpSold": 59951166.261611156, "volumeAll": 118042144.47067384, "tradesAll": 417846, "profitAll": 2511974.592434152, "roiAll": -0.5639948599211692, "xrpBoughtAll": 58090978.20906269, "xrpSoldAll": 59951166.261611156, "tokensBought": 75052445.7994075, "tokensSold": 77321809.1509999, "buyCount": 186763, "sellCount": 231083, "avgBuyPrice": 0.774005131882342, "avgSellPrice": 0.775346139981463, "avgBuyMcap": 547498807.1734276, "avgSellMcap": 548447380.1278383, "lastTradeDate": 1793515712000, "firstTradeDate": 1785151650000, "washTradingScore": 100, "suspiciousActivity": true, "actualBalance": 236928.0910298889, "unrealizedPnl": -1355.4521066772286, "holdingValue": 189088.99866235696, "totalPnl": 2510619.140327475, "totalRoi": -0.5639948599211692 } ], "count": 50, "total": 46920, "offset": 0, "sortBy": "volume", "limit": 50, "responseTime": "390ms" }
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 →