/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": 22992.5862126879, "ammTokensBought": 7463948.74775252, "ammTrades": 32339, "ammVolume": 9398955.201606002, "avgBuyPrice": 0.605326551286028, "avgSellPrice": 0.604338294874936, "balanceLastUpdated": "2026-11-01T06:56:36.294Z", "buyCount": 622969, "buyVolume": 204797798.50729808, "dexTokensBought": 64832465.1852419, "dexTrades": 1224967, "dexVolume": 400365938.2464235, "firstTradeDate": 1734541501000, "inferredReceived": 856382.4598151378, "lastTradeDate": 1793516192000, "profit24h": 48942.60467900005, "profit30d": 5297.560445999869, "profit7d": -1683.9818039999614, "sellCount": 634337, "sellRatio": 50.452077696280774, "sellVolume": 204967094.94073138, "sourceTagStats": [], "suspiciousActivity": true, "tokenDeposited": 0, "tokenWithdrawn": 0, "tokensBought": 338326144.908399, "tokensSold": 339159534.782001, "totalTrades": 1257306, "tradePercentage": 6.272561632500584, "trades24h": 1312, "trades30d": 76334, "trades7d": 17347, "updatedAt": "2026-11-01T06:56:36.295Z", "volume24h": 313452.29119699984, "volume30d": 24231591.989253994, "volume7d": 5043611.249023999, "washSelfTrades": 0 }, { "_id": "6ad180cef6db4d311430f809", "tokenId": "0dd550278b74cb6690fdae351e8e0df3", "address": "r3nVVxJfkdvjiXP1tov5pZdht96JMwGApP", "actualBalance": 79.49281537092455, "ammTokensBought": 709262.198879787, "ammTrades": 5216, "ammVolume": 942842.1909319998, "avgBuyPrice": 0.747454061749685, "avgSellPrice": 0.747731856528328, "balanceLastUpdated": "2026-11-01T06:37:41.418Z", "buyCount": 35299, "buyVolume": 7582126.476214056, "dexTokensBought": 9434674.21704617, "dexTrades": 65310, "dexVolume": 14224169.254757049, "firstTradeDate": 1789654922000, "inferredReceived": 1.70685126e-7, "lastTradeDate": 1793515060000, "profit24h": -114.11755100000119, "profit30d": 2499.309431000019, "profit7d": 5639.333887000046, "sellCount": 35227, "sellRatio": 49.948954995320875, "sellVolume": 7584884.969474994, "sourceTagStats": [], "suspiciousActivity": true, "tokenDeposited": 0, "tokenWithdrawn": 0, "tokensBought": 10143936.4159255, "tokensSold": 10143856.9231103, "totalTrades": 70526, "tradePercentage": 0.351849527378369, "trades24h": 1326, "trades30d": 55154, "trades7d": 17462, "updatedAt": "2026-11-01T06:37:41.418Z", "volume24h": 228612.49045299995, "volume30d": 13873287.688254997, "volume7d": 4636841.690982998, "washSelfTrades": 0 }, { "_id": "6ad1801cf6db4d311430d27a", "tokenId": "0dd550278b74cb6690fdae351e8e0df3", "address": "r3cpW3M3nKHfSgkJiEh1BaAy6GJXeZvMLU", "actualBalance": 21498.19348728689, "ammTokensBought": 2344864.83179554, "ammTrades": 12562, "ammVolume": 3352833.486558995, "avgBuyPrice": 0.785000007793514, "avgSellPrice": 0.785458403921201, "balanceLastUpdated": "2026-11-01T06:50:24.405Z", "buyCount": 119425, "buyVolume": 33916108.40970101, "dexTokensBought": 40860367.3210196, "dexTrades": 205792, "dexVolume": 64482302.50770112, "firstTradeDate": 1776353782000, "inferredReceived": 8.86942871e-7, "lastTradeDate": 1793515821000, "profit24h": -6979.561341999997, "profit30d": -14408.337459999984, "profit7d": -17204.503468000014, "sellCount": 98929, "sellRatio": 45.30670379292342, "sellVolume": 33919027.584559105, "sourceTagStats": [], "suspiciousActivity": true, "tokenDeposited": 0, "tokenWithdrawn": 0, "tokensBought": 43205233.2139878, "tokensSold": 43183735.0205014, "totalTrades": 218354, "tradePercentage": 1.089347617702515, "trades24h": 460, "trades30d": 26589, "trades7d": 5358, "updatedAt": "2026-11-01T06:50:24.405Z", "volume24h": 165878.478914, "volume30d": 11135504.052434003, "volume7d": 2414811.1501800003, "washSelfTrades": 0 }, { "_id": "6ad18060f6db4d311430e36b", "address": "rKYdJJLAgxbJcn9Ria2X5jMMiqP91r4qy", "tokenId": "0dd550278b74cb6690fdae351e8e0df3", "actualBalance": 2938.698325462184, "ammTokensBought": 1480111.63330113, "ammTrades": 13229, "ammVolume": 2086762.1745229966, "avgBuyPrice": 0.745074497215812, "avgSellPrice": 0.74534187960481, "balanceLastUpdated": "2026-11-01T07:00:20.229Z", "buyCount": 125611, "buyVolume": 19855711.340181094, "dexTokensBought": 25169185.0670653, "dexTrades": 222807, "dexVolume": 37629595.72352192, "firstTradeDate": 1782147122000, "inferredReceived": 0, "lastTradeDate": 1793516420000, "profit24h": 3298.1711919999952, "profit30d": -702.0238679999748, "profit7d": 5892.213659000008, "sellCount": 110425, "sellRatio": 46.783117829483636, "sellVolume": 19860646.55786382, "sourceTagStats": [], "suspiciousActivity": true, "tokenDeposited": 0, "tokenWithdrawn": 0, "tokensBought": 26649296.7003672, "tokensSold": 26646358.0020409, "totalTrades": 236036, "tradePercentage": 1.177556756812848, "trades24h": 775, "trades30d": 44045, "trades7d": 8811, "updatedAt": "2026-11-01T07:00:20.229Z", "volume24h": 152526.6964599999, "volume30d": 11131903.569748001, "volume7d": 2363807.398655, "washSelfTrades": 0 }, { "_id": "6ad180c1f6db4d311430f377", "address": "rKfa1JLEDBg3MJcs1Tozi3unKfU3PeZq5y", "tokenId": "0dd550278b74cb6690fdae351e8e0df3", "actualBalance": 18013.12006083135, "ammTokensBought": 32152.3667892021, "ammTrades": 150, "ammVolume": 52875.684671999996, "avgBuyPrice": 0.695312209899097, "avgSellPrice": 0.694895507875461, "balanceLastUpdated": "2026-11-01T06:25:51.628Z", "buyCount": 7775, "buyVolume": 7253649.144511998, "dexTokensBought": 101904.967859941, "dexTrades": 16311, "dexVolume": 14437558.241431989, "firstTradeDate": 1788313502000, "inferredReceived": 0, "lastTradeDate": 1793514350000, "profit24h": 10.508690999997725, "profit30d": 252.69066099998577, "profit7d": 1.809334999999702, "sellCount": 8686, "sellRatio": 52.76714658890711, "sellVolume": 7236784.781591991, "sourceTagStats": [ { "sourceTag": 10011010, "trades": 12, "volume": 232.56094099999999, "profit": 232.56094099999999 } ], "suspiciousActivity": true, "tokenDeposited": 0, "tokenWithdrawn": 0, "tokensBought": 10432218.852542, "tokensSold": 10414205.7324811, "totalTrades": 16461, "tradePercentage": 0.082123138310212, "trades24h": 160, "trades30d": 2937, "trades7d": 197, "updatedAt": "2026-11-01T06:25:51.628Z", "volume24h": 133945.330457, "volume30d": 1828390.9539450004, "volume7d": 180049.530811, "washSelfTrades": 0 } ], "total": 46920, "page": 1, "limit": 50, "totalPages": 939 }
Long arrays and strings are shortened in the example; Send request for the full answer.
What it does
Top traders for token