/v1/token/analytics/token/{id}/traders
Top traders for token
Request
https://api.xrpl.to/v1/token/analytics/token/0dd550278b74cb6690fdae351e8e0df3/traders| Path parameter | Value | Description |
|---|---|---|
| id | A token id: its md5, slug or issuer_currency |
| Query parameter | Value | Description |
|---|---|---|
| offset | int | |
| limit | int (max 100, default 50) | |
| sort | volume24h|volume7d|volume30d|volumeTotal|trades24h|tradesTotal|realizedPnl|unrealizedPnl|totalPnl|holding|lastTradeAt|firstTradeAt | |
| address | filter |
curl 'https://api.xrpl.to/v1/token/analytics/token/0dd550278b74cb6690fdae351e8e0df3/traders'
Response
https://api.xrpl.to/v1/token/analytics/token/0dd550278b74cb6690fdae351e8e0df3/traders{ "traders": [ { "_id": "6ad18088f6db4d311430e90c", "address": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns", "tokenId": "0dd550278b74cb6690fdae351e8e0df3", "actualBalance": 520121.2003653334, "ammTokensBought": 185865.389492493, "ammTrades": 1135, "ammVolume": 341174.113031, "avgBuyPrice": 0.774408940882911, "avgSellPrice": 0.776209578811914, "balanceLastUpdated": "2026-10-19T08:21:08.099Z", "buyCount": 165690, "buyVolume": 48125215.576542936, "dexTokensBought": 1767192.53481088, "dexTrades": 371683, "dexVolume": 97743182.96355365, "firstTradeDate": 1785151650000, "inferredReceived": 2738628.059478639, "lastTradeDate": 1792398062000, "profit24h": 32561.813512000102, "profit30d": -1174783.7847820015, "profit7d": -499196.62903400033, "sellCount": 207128, "sellRatio": 55.55740334425913, "sellVolume": 49959141.500041716, "sourceTagStats": [], "suspiciousActivity": true, "tokenDeposited": 0, "tokenWithdrawn": 0, "tokensBought": 62144447.2498922, "tokensSold": 64362954.1090055, "totalTrades": 372818, "tradePercentage": 1.918316984518365, "trades24h": 4806, "trades30d": 127961, "trades7d": 32715, "updatedAt": "2026-10-19T08:21:08.099Z", "volume24h": 1542531.9897939996, "volume30d": 27848695.091554016, "volume7d": 15147541.219148, "washSelfTrades": 195 }, { "_id": "6ad17d92f6db4d31142fb436", "address": "rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ", "tokenId": "0dd550278b74cb6690fdae351e8e0df3", "actualBalance": 21559.60277013761, "ammTokensBought": 7436197.30759177, "ammTrades": 31891, "ammVolume": 9309957.167429004, "avgBuyPrice": 0.60222247151878, "avgSellPrice": 0.601234725652875, "balanceLastUpdated": "2026-10-19T08:34:39.434Z", "buyCount": 611590, "buyVolume": 199958659.24922705, "dexTokensBought": 64136905.2155621, "dexTrades": 1190329, "dexVolume": 390781320.0815707, "firstTradeDate": 1734541501000, "inferredReceived": 856382.4597595213, "lastTradeDate": 1792398880000, "profit24h": 2955.516629000004, "profit30d": 3948.9126749998845, "profit7d": 1560.286037999938, "sellCount": 610630, "sellRatio": 49.960727201322186, "sellVolume": 200132617.9997727, "sourceTagStats": [], "suspiciousActivity": true, "tokenDeposited": 0, "tokenWithdrawn": 0, "tokensBought": 332034536.580709, "tokensSold": 332869359.437698, "totalTrades": 1222220, "tradePercentage": 6.288795579000686, "trades24h": 2763, "trades30d": 132268, "trades7d": 18316, "updatedAt": "2026-10-19T08:34:39.434Z", "volume24h": 782242.1279530001, "volume30d": 40442117.633836985, "volume7d": 6681568.826498001, "washSelfTrades": 0 }, { "_id": "6ad180cef6db4d311430f809", "tokenId": "0dd550278b74cb6690fdae351e8e0df3", "address": "r3nVVxJfkdvjiXP1tov5pZdht96JMwGApP", "actualBalance": 3372.90524078904, "ammTokensBought": 383643.848532603, "ammTrades": 3564, "ammVolume": 523893.71265199984, "avgBuyPrice": 0.720688614870358, "avgSellPrice": 0.72099669300517, "balanceLastUpdated": "2026-10-19T08:31:02.432Z", "buyCount": 19059, "buyVolume": 3436311.1102919998, "dexTokensBought": 4384450.22065166, "dexTrades": 33974, "dexVolume": 6347765.599934995, "firstTradeDate": 1789654922000, "inferredReceived": 0, "lastTradeDate": 1792398661000, "profit24h": -1363.0116159999948, "profit30d": -912.6286169999952, "profit7d": -1582.2784879999922, "sellCount": 18479, "sellRatio": 49.22744951782194, "sellVolume": 3435348.2022949955, "sourceTagStats": [], "suspiciousActivity": true, "tokenDeposited": 0, "tokenWithdrawn": 0, "tokensBought": 4768094.0691843, "tokensSold": 4764721.16394348, "totalTrades": 37538, "tradePercentage": 0.193148850059934, "trades24h": 2098, "trades30d": 36581, "trades7d": 12219, "updatedAt": "2026-10-19T08:31:02.432Z", "volume24h": 569361.0472980002, "volume30d": 6856595.258071002, "volume7d": 3857364.389146001, "washSelfTrades": 0 }, { "_id": "6ad1801cf6db4d311430d27a", "tokenId": "0dd550278b74cb6690fdae351e8e0df3", "address": "r3cpW3M3nKHfSgkJiEh1BaAy6GJXeZvMLU", "actualBalance": 26520.42871298479, "ammTokensBought": 2239299.45078693, "ammTrades": 11725, "ammVolume": 3176979.8770789984, "avgBuyPrice": 0.785863307310414, "avgSellPrice": 0.786366074873373, "balanceLastUpdated": "2026-10-19T08:17:03.439Z", "buyCount": 114370, "buyVolume": 31854349.300090007, "dexTokensBought": 38294910.7227026, "dexTrades": 196173, "dexVolume": 60531243.24427003, "firstTradeDate": 1776353782000, "inferredReceived": 0.000001354386768, "lastTradeDate": 1792397821000, "profit24h": -1171.066127999995, "profit30d": -8998.968554000163, "profit7d": -1527.5152489999673, "sellCount": 93528, "sellRatio": 44.98744576667404, "sellVolume": 31853873.82125901, "sourceTagStats": [], "suspiciousActivity": true, "tokenDeposited": 0, "tokenWithdrawn": 0, "tokensBought": 40534211.2346615, "tokensSold": 40507690.8059499, "totalTrades": 207898, "tradePercentage": 1.06974165207571, "trades24h": 1001, "trades30d": 37528, "trades7d": 7216, "updatedAt": "2026-10-19T08:17:03.439Z", "volume24h": 366030.6578680002, "volume30d": 13358070.063544003, "volume7d": 3427742.3611870017, "washSelfTrades": 0 }, { "_id": "6ad18060f6db4d311430e36b", "address": "rKYdJJLAgxbJcn9Ria2X5jMMiqP91r4qy", "tokenId": "0dd550278b74cb6690fdae351e8e0df3", "actualBalance": 350.1553118871895, "ammTokensBought": 1381912.16928418, "ammTrades": 12258, "ammVolume": 1932203.635511999, "avgBuyPrice": 0.742253603668132, "avgSellPrice": 0.742530884370444, "balanceLastUpdated": "2026-10-19T08:34:54.911Z", "buyCount": 117436, "buyVolume": 17720493.696096055, "dexTokensBought": 22491995.088994, "dexTrades": 206402, "dexVolume": 33515143.529318076, "firstTradeDate": 1782147122000, "inferredReceived": 0, "lastTradeDate": 1792398891000, "profit24h": -316.01221199999145, "profit30d": 1891.5631609999382, "profit7d": 7310.854004000012, "sellCount": 101224, "sellRatio": 46.29287478276777, "sellVolume": 17726853.46873402, "sourceTagStats": [], "suspiciousActivity": true, "tokenDeposited": 0, "tokenWithdrawn": 0, "tokensBought": 23873907.2582786, "tokensSold": 23873557.1029665, "totalTrades": 218660, "tradePercentage": 1.125089748367035, "trades24h": 1599, "trades30d": 58763, "trades7d": 11372, "updatedAt": "2026-10-19T08:34:54.911Z", "volume24h": 356561.18707199994, "volume30d": 14173881.607626997, "volume7d": 3402650.168907999, "washSelfTrades": 0 } ], "total": 46366, "page": 1, "limit": 50, "totalPages": 928 }
Long arrays and strings are shortened in the example; Send request for the full answer.
What it does
Top traders for token