/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": "6ad17d92f6db4d31142fb436", "address": "rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ", "tokenId": "0dd550278b74cb6690fdae351e8e0df3", "actualBalance": 91506.01196476084, "ammTokensBought": 7569722.11205548, "ammTrades": 33401, "ammVolume": 9656049.545037007, "avgBuyPrice": 0.627263268856845, "avgSellPrice": 0.626162542853946, "balanceLastUpdated": "2026-11-21T04:16:35.381Z", "buyCount": 655797, "buyVolume": 224971029.14864686, "dexTokensBought": 66757092.1044865, "dexTrades": 1320157, "dexVolume": 440370164.98720646, "firstTradeDate": 1734541501000, "inferredReceived": 856382.4600325451, "lastTradeDate": 1795234590000, "profit24h": -89754.29014699995, "profit30d": -85377.70514199948, "profit7d": -86594.36522099994, "sellCount": 697761, "sellRatio": 51.55013675069705, "sellVolume": 225055185.3835966, "sourceTagStats": [], "suspiciousActivity": true, "tokenDeposited": 0, "tokenWithdrawn": 0, "tokensBought": 358654874.784307, "tokensSold": 359419751.232375, "totalTrades": 1353558, "tradePercentage": 6.353511207751899, "trades24h": 8959, "trades30d": 121153, "trades7d": 42915, "updatedAt": "2026-11-21T04:16:35.381Z", "volume24h": 5804042.849187003, "volume30d": 47635299.17194201, "volume7d": 25114611.454617012, "washSelfTrades": 0 }, { "_id": "6ad18088f6db4d311430e90c", "address": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns", "tokenId": "0dd550278b74cb6690fdae351e8e0df3", "actualBalance": 363674.3044511284, "ammTokensBought": 216599.419736953, "ammTrades": 1238, "ammVolume": 375421.33947300015, "avgBuyPrice": 0.801009094041801, "avgSellPrice": 0.804334561785586, "balanceLastUpdated": "2026-11-21T17:30:36.586Z", "buyCount": 195188, "buyVolume": 69052776.90233016, "dexTokensBought": 2613004.37146659, "dexTrades": 437144, "dexVolume": 141412119.28194958, "firstTradeDate": 1785151650000, "inferredReceived": 4584936.958539223, "lastTradeDate": 1795282232000, "profit24h": 8419.706548000046, "profit30d": 1824204.884768002, "profit7d": 426321.8024710006, "sellCount": 243194, "sellRatio": 55.47536167087153, "sellVolume": 72734763.71909241, "sourceTagStats": [], "suspiciousActivity": true, "tokenDeposited": 0, "tokenWithdrawn": 0, "tokensBought": 86207232.1225439, "tokensSold": 90428494.776632, "totalTrades": 438382, "tradePercentage": 2.054072299941355, "trades24h": 3493, "trades30d": 54841, "trades7d": 8049, "updatedAt": "2026-11-21T17:30:36.586Z", "volume24h": 5360755.927553998, "volume30d": 40097092.790416, "volume7d": 12920835.714436999, "washSelfTrades": 233 }, { "_id": "6ad180cef6db4d311430f809", "tokenId": "0dd550278b74cb6690fdae351e8e0df3", "address": "r3nVVxJfkdvjiXP1tov5pZdht96JMwGApP", "actualBalance": 9.85739602, "ammTokensBought": 1267383.30829358, "ammTrades": 8478, "ammVolume": 1874349.7991580036, "avgBuyPrice": 0.870029721015496, "avgSellPrice": 0.870394858512156, "balanceLastUpdated": "2026-11-21T17:30:36.578Z", "buyCount": 71101, "buyVolume": 18549173.401023936, "dexTokensBought": 20052777.3172209, "dexTrades": 134221, "dexVolume": 35231773.21314096, "firstTradeDate": 1789654922000, "inferredReceived": 0, "lastTradeDate": 1795282232000, "profit24h": 4875.491334000018, "profit30d": 6203.547350000044, "profit7d": 3291.129023000023, "sellCount": 71598, "sellRatio": 50.17414277605309, "sellVolume": 18556949.61127503, "sourceTagStats": [], "suspiciousActivity": true, "tokenDeposited": 0, "tokenWithdrawn": 0, "tokensBought": 21320160.6255168, "tokensSold": 21320150.7681193, "totalTrades": 142699, "tradePercentage": 0.668627049307069, "trades24h": 6487, "trades30d": 97159, "trades7d": 28657, "updatedAt": "2026-11-21T17:30:36.578Z", "volume24h": 2926942.851869999, "volume30d": 28751517.585051995, "volume7d": 12504665.631998997, "washSelfTrades": 0 }, { "_id": "6ad1801cf6db4d311430d27b", "address": "rpK3DLr8vDhPDGEPRKSjb65gdgehDga4ZZ", "tokenId": "0dd550278b74cb6690fdae351e8e0df3", "actualBalance": 7507.900614538962, "ammTokensBought": 2379563.5900115, "ammTrades": 13336, "ammVolume": 3527950.006034999, "avgBuyPrice": 0.803355370454316, "avgSellPrice": 0.803994752292095, "balanceLastUpdated": "2026-11-21T17:32:49.017Z", "buyCount": 120753, "buyVolume": 40374651.04862912, "dexTokensBought": 47877956.7615957, "dexTrades": 210976, "dexVolume": 77247449.52598578, "firstTradeDate": 1776353861000, "inferredReceived": 0.000008569831152, "lastTradeDate": 1795282370000, "profit24h": 27258.05401899999, "profit30d": 17536.15995300017, "profit7d": 14930.147394000045, "sellCount": 103559, "sellRatio": 46.16739184707016, "sellVolume": 40400748.48339165, "sourceTagStats": [], "suspiciousActivity": true, "tokenDeposited": 0, "tokenWithdrawn": 0, "tokensBought": 50257523.0508465, "tokensSold": 50250015.1502405, "totalTrades": 224312, "tradePercentage": 1.051028819233464, "trades24h": 1929, "trades30d": 28120, "trades7d": 7697, "updatedAt": "2026-11-21T17:32:49.017Z", "volume24h": 1704423.6335850002, "volume30d": 13184024.327883, "volume7d": 5782159.321448001, "washSelfTrades": 0 }, { "_id": "6ad17e89f6db4d3114304925", "address": "rK2pFxGGZxoUhHN63Mg4CuzbicP9mzUANC", "tokenId": "0dd550278b74cb6690fdae351e8e0df3", "actualBalance": 0, "ammTokensBought": 38259.5085901358, "ammTrades": 53, "ammVolume": 64353.499799000005, "avgBuyPrice": 0.764004491843517, "avgSellPrice": 0.763296566031361, "balanceLastUpdated": "2026-11-20T23:44:20.657Z", "buyCount": 3890, "buyVolume": 5913594.865134999, "dexTokensBought": 451082.186418404, "dexTrades": 7924, "dexVolume": 11757356.699274002, "firstTradeDate": 1753999642000, "inferredReceived": 3480.569594448406, "lastTradeDate": 1795218262000, "profit24h": 172427.46697200005, "profit30d": 7842.854785999873, "profit7d": 172328.40607099998, "sellCount": 4087, "sellRatio": 51.234800050144166, "sellVolume": 5908115.3339380035, "sourceTagStats": [], "suspiciousActivity": true, "tokenDeposited": 0, "tokenWithdrawn": 0, "tokensBought": 7740261.90718551, "tokensSold": 7740261.90718545, "totalTrades": 7977, "tradePercentage": 0.037466531636228, "trades24h": 711, "trades30d": 3490, "trades7d": 1647, "updatedAt": "2026-11-20T23:44:28.145Z", "volume24h": 1561827.466972, "volume30d": 6229354.733695999, "volume7d": 3687158.406071, "washSelfTrades": 0 } ], "total": 47667, "page": 1, "limit": 50, "totalPages": 954 }
Long arrays and strings are shortened in the example; Send request for the full answer.
What it does
Top traders for token