XRPL.to
GET /token/analytics/token/{id}/traders
GET

/v1/token/analytics/token/{id}/traders

Top traders for token

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/token/analytics/token/0dd550278b74cb6690fdae351e8e0df3/traders
Path parameterValueDescription
idA token id: its md5, slug or issuer_currency
Query parameterValueDescription
offsetint
limitint (max 100, default 50)
sortvolume24h|volume7d|volume30d|volumeTotal|trades24h|tradesTotal|realizedPnl|unrealizedPnl|totalPnl|holding|lastTradeAt|firstTradeAt
addressfilter
curl 'https://api.xrpl.to/v1/token/analytics/token/0dd550278b74cb6690fdae351e8e0df3/traders'

Response

200Example response174 ms · just now · 7.4 KB · 218 lines
https://api.xrpl.to/v1/token/analytics/token/0dd550278b74cb6690fdae351e8e0df3/traders
{
  "traders": [
    {
      "_id": "6a6740be7690aa46ea98d709",
      "address": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns",
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "actualBalance": 299996.1320812324,
      "ammTokensBought": 172902.361703211,
      "ammTrades": 1100,
      "ammVolume": 323971.4046399998,
      "avgBuyPrice": 0.778047825804488,
      "avgHoldingTime": 0.899566135885131,
      "avgSellPrice": 0.779601280581937,
      "balanceLastUpdated": "2026-10-12T01:52:05.725Z",
      "buyCount": 149735,
      "buyVolume": 40317997.94611782,
      "dexTokensBought": 1664281.81141435,
      "dexTrades": 339104,
      "dexVolume": 82638907.35465175,
      "firstTradeDate": 1785151650000,
      "inferredReceived": 3181448.1970281745,
      "lastTradeDate": 1791769921000,
      "profit24h": 191.31866800002354,
      "profit30d": -575954.8642459987,
      "profit7d": -690682.5669499993,
      "sellCount": 190469,
      "sellRatio": 55.98670209638923,
      "sellVolume": 42644880.813173935,
      "sourceTagStats": [],
      "suspiciousActivity": true,
      "tokenDeposited": 0,
      "tokenWithdrawn": 0,
      "tokensBought": 51819433.9845751,
      "tokensSold": 54700886.049522,
      "totalTrades": 340204,
      "tradePercentage": 1.779071421399645,
      "trades24h": 2207,
      "trades30d": 120375,
      "trades7d": 27944,
      "updatedAt": "2026-10-12T01:52:05.725Z",
      "volume24h": 450609.370178,
      "volume30d": 13958837.715442006,
      "volume7d": 10692344.657394007
    },
    {
      "_id": "6a54b5517690aa46ea33b0f2",
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "address": "rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ",
      "actualBalance": 32703.20289121745,
      "ammTokensBought": 7400751.13992256,
      "ammTrades": 31694,
      "ammVolume": 9246555.09862198,
      "avgBuyPrice": 0.600178112141115,
      "avgHoldingTime": 1414.695213226818,
      "avgSellPrice": 0.599190813461216,
      "balanceLastUpdated": "2026-10-12T01:55:18.375Z",
      "buyCount": 603063,
      "buyVolume": 196625457.74172503,
      "dexTokensBought": 63666393.9026177,
      "dexTrades": 1172237,
      "dexVolume": 384174220.76788735,
      "firstTradeDate": 1734541501000,
      "inferredReceived": 855998.7417662608,
      "lastTradeDate": 1791770112000,
      "profit24h": -2877.758984999998,
      "profit30d": -3580.140955999914,
      "profit7d": -1558.8164019999815,
      "sellCount": 600868,
      "sellRatio": 49.90884029068111,
      "sellVolume": 196795318.12478426,
      "sourceTagStats": [],
      "suspiciousActivity": true,
      "tokenDeposited": 0,
      "tokenWithdrawn": 0,
      "tokensBought": 327611843.491377,
      "tokensSold": 328435139.030252,
      "totalTrades": 1203931,
      "tradePercentage": 6.295834366139438,
      "trades24h": 924,
      "trades30d": 149879,
      "trades7d": 12946,
      "updatedAt": "2026-10-12T01:55:18.375Z",
      "volume24h": 268987.95746699994,
      "volume30d": 48945073.69835001,
      "volume7d": 5332712.514598002
    },
    {
      "_id": "6a54b7237690aa46ea34c205",
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "address": "rDi2VysuPsU5oQRGPDTPiR9YPd34kzK9m8",
      "actualBalance": 28314.81053865804,
      "ammTokensBought": 2420983.4391864,
      "ammTrades": 12865,
      "ammVolume": 3547486.305677007,
      "avgBuyPrice": 0.776184011823528,
      "avgHoldingTime": 459.41991535709303,
      "avgSellPrice": 0.776578964159148,
      "balanceLastUpdated": "2026-10-12T01:56:38.581Z",
      "buyCount": 149970,
      "buyVolume": 33937174.09079774,
      "dexTokensBought": 41300900.4772143,
      "dexTrades": 257792,
      "dexVolume": 64322141.718603246,
      "firstTradeDate": 1774029232000,
      "inferredReceived": 0,
      "lastTradeDate": 1791770192000,
      "profit24h": 395.8273190000009,
      "profit30d": -2692.013557000194,
      "profit7d": -19422.759362000004,
      "sellCount": 120687,
      "sellRatio": 44.59038561722032,
      "sellVolume": 33932453.93348252,
      "sourceTagStats": [],
      "suspiciousActivity": true,
      "tokenDeposited": 0,
      "tokenWithdrawn": 0,
      "tokensBought": 43723103.7664219,
      "tokensSold": 43694788.9391047,
      "totalTrades": 270657,
      "tradePercentage": 1.415370066426805,
      "trades24h": 504,
      "trades30d": 41794,
      "trades7d": 7552,
      "updatedAt": "2026-10-12T01:56:38.581Z",
      "volume24h": 158044.644803,
      "volume30d": 13578716.266521,
      "volume7d": 3331595.5092620007
    },
    {
      "_id": "6a54b6f17690aa46ea348293",
      "address": "rwDbSDTC9z9uBWgVCJXov58cqH1gNKtoYb",
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "actualBalance": 1036.086684207061,
      "ammTokensBought": 106486.948271195,
      "ammTrades": 116,
      "ammVolume": 210344.639484,
      "avgBuyPrice": 0.746966672288592,
      "avgHoldingTime": 15415.123500726257,
      "avgSellPrice": 0.746111232570176,
      "balanceLastUpdated": "2026-10-11T22:45:31.407Z",
      "buyCount": 10930,
      "buyVolume": 18239614.426230986,
      "dexTokensBought": 2079359.74835467,
      "dexTrades": 25492,
      "dexVolume": 36223790.10596597,
      "firstTradeDate": 1772326352000,
      "inferredReceived": 0,
      "lastTradeDate": 1791758730000,
      "profit24h": 27223.470432000002,
      "profit30d": 22463.798286999932,
      "profit7d": 27644.60284799996,
      "sellCount": 14678,
      "sellRatio": 57.318025616994696,
      "sellVolume": 18194520.31921899,
      "sourceTagStats": [],
      "suspiciousActivity": false,
      "tokenDeposited": 0,
      "tokenWithdrawn": 0,
      "tokensBought": 24418243.94969,
      "tokensSold": 24385801.3724618,
      "totalTrades": 25608,
      "tradePercentage": 0.133938476379745,
      "trades24h": 121,
      "trades30d": 2657,
      "trades7d": 1357,
      "updatedAt": "2026-10-11T22:45:31.407Z",
      "volume24h": 139993.769056,
      "volume30d": 5285178.692773,
      "volume7d": 2657835.7953499993
    },
    {
      "_id": "6a54b75d7690aa46ea34ce08",
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "address": "rPztkopzNn1ShL8JbeqbJZ3RyXZqcRBPyi",
      "actualBalance": 24963.81762838337,
      "ammTokensBought": 1494028.12144732,
      "ammTrades": 7873,
      "ammVolume": 2118445.896759002,
      "avgBuyPrice": 0.793097164603908,
      "avgHoldingTime": 807.6795410979353,
      "avgSellPrice": 0.79360212639928,
      "balanceLastUpdated": "2026-10-12T01:56:30.461Z",
      "buyCount": 79299,
      "buyVolume": 22489481.296536963,
      "dexTokensBought": 26862497.9873751,
      "dexTrades": 136281,
      "dexVolume": 42855024.33750174,
      "firstTradeDate": 1776353710000,
      "inferredReceived": 0.021508883419301,
      "lastTradeDate": 1791770190000,
      "profit24h": -3218.870903000008,
      "profit30d": 1003.6134759999059,
      "profit7d": -16937.94322300006,
      "sellCount": 64855,
      "sellRatio": 44.99008005327635,
      "sellVolume": 22483988.937723782,
      "sourceTagStats": [],
      "suspiciousActivity": true,
      "tokenDeposited": 0,
      "tokenWithdrawn": 0,
      "tokensBought": 28356527.1699953,
      "tokensSold": 28331563.3738758,
      "totalTrades": 144154,
      "tradePercentage": 0.753837062757874,
      "trades24h": 455,
      "trades30d": 26079,
      "trades7d": 4578,
      "updatedAt": "2026-10-12T01:56:30.461Z",
      "volume24h": 135340.528331,
      "volume30d": 8571424.105423998,
      "volume7d": 1959458.2187410006
    }
  ],
  "total": 45986,
  "page": 1,
  "limit": 50,
  "totalPages": 920
}

Long arrays and strings are shortened in the example; Send request for the full answer.

What it does

Top traders for token

A token id can be its md5, slug or issuer_currency. How to build an md5 →
OpenAPI
PrevGET/token/analytics/token/{id}NextGET/traders/rotations/{tokenId}