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 response143 ms · just now · 7.4 KB · 218 lines
https://api.xrpl.to/v1/token/analytics/token/0dd550278b74cb6690fdae351e8e0df3/traders
{
  "traders": [
    {
      "_id": "6a54b5517690aa46ea33b0f2",
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "address": "rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ",
      "actualBalance": 33937.88804680508,
      "ammTokensBought": 7173401.550614616,
      "ammTrades": 30470,
      "ammVolume": 8814929.924512982,
      "avgBuyPrice": 0.595471418797063,
      "avgHoldingTime": 1546.0090826229177,
      "avgSellPrice": 0.594428313978194,
      "balanceLastUpdated": "2026-09-21T07:30:20.773Z",
      "buyCount": 555460,
      "buyVolume": 182060023.11602354,
      "dexTokensBought": 62688363.934061654,
      "dexTrades": 1071202,
      "dexVolume": 355474852.65113986,
      "firstTradeDate": 1734541501000,
      "inferredReceived": 855998.7417612115,
      "lastTradeDate": 1789975820000,
      "profit24h": -2669.2340180000037,
      "profit30d": 34062.27195599997,
      "profit7d": -648.1819200000332,
      "sellCount": 546212,
      "sellRatio": 49.58027434662949,
      "sellVolume": 182229759.45962933,
      "sourceTagStats": [],
      "suspiciousActivity": false,
      "tokenDeposited": 0,
      "tokenWithdrawn": 0,
      "tokensBought": 305740993.38696414,
      "tokensSold": 306563054.24067855,
      "totalTrades": 1101672,
      "tradePercentage": 6.187574369884254,
      "trades24h": 5915,
      "trades30d": 166859,
      "trades7d": 45838,
      "updatedAt": "2026-09-21T07:30:20.773Z",
      "volume24h": 2449351.9678399996,
      "volume30d": 57140106.08609802,
      "volume7d": 19006920.002324007
    },
    {
      "_id": "6a977fa7f6db4d3114a24380",
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "address": "rKfa1JLEDBg3MJcs1Tozi3unKfU3PeZq5y",
      "actualBalance": 0,
      "ammTokensBought": 17320.893706974108,
      "ammTrades": 94,
      "ammVolume": 33841.07921999999,
      "avgBuyPrice": 0.719878757741239,
      "avgHoldingTime": 0,
      "avgSellPrice": 0.719429301091874,
      "balanceLastUpdated": "2026-09-21T07:22:03.019Z",
      "buyCount": 3788,
      "buyVolume": 4150306.109856004,
      "dexTokensBought": 63601.66462686935,
      "dexTrades": 7126,
      "dexVolume": 8264179.894871998,
      "firstTradeDate": 1788313502000,
      "inferredReceived": 9.313226e-9,
      "lastTradeDate": 1789975320000,
      "profit24h": 14514.412768999997,
      "profit30d": -2591.2456200000215,
      "profit7d": -1724.871586999996,
      "sellCount": 3432,
      "sellRatio": 47.53462603878116,
      "sellVolume": 4147714.864235993,
      "sourceTagStats": [],
      "suspiciousActivity": true,
      "tokenDeposited": 0,
      "tokenWithdrawn": 0,
      "tokensBought": 5765284.86946697,
      "tokensSold": 5765284.869466979,
      "totalTrades": 7220,
      "tradePercentage": 0.040552006038093,
      "trades24h": 1323,
      "trades30d": 7220,
      "trades7d": 4379,
      "updatedAt": "2026-09-21T07:22:03.019Z",
      "volume24h": 1852406.1055790002,
      "volume30d": 8298020.974092001,
      "volume7d": 4757768.798231
    },
    {
      "_id": "6a54b75d7690aa46ea34ce0b",
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "address": "rpK3DLr8vDhPDGEPRKSjb65gdgehDga4ZZ",
      "actualBalance": 10508.25514148711,
      "ammTokensBought": 1673446.9061626242,
      "ammTrades": 8340,
      "ammVolume": 2507978.2753539956,
      "avgBuyPrice": 0.808750820673765,
      "avgHoldingTime": 568.8939507098728,
      "avgSellPrice": 0.809296395254424,
      "balanceLastUpdated": "2026-09-21T07:30:16.663Z",
      "buyCount": 89281,
      "buyVolume": 27060056.273125846,
      "dexTokensBought": 31785627.75368262,
      "dexTrades": 152579,
      "dexVolume": 51621884.315742664,
      "firstTradeDate": 1776353861000,
      "inferredReceived": 0,
      "lastTradeDate": 1789975811000,
      "profit24h": 14245.938346999996,
      "profit30d": 13044.928277999916,
      "profit7d": 9364.478264999947,
      "sellCount": 71638,
      "sellRatio": 44.51804945345174,
      "sellVolume": 27069806.317970816,
      "sourceTagStats": [],
      "suspiciousActivity": true,
      "tokenDeposited": 0,
      "tokenWithdrawn": 0,
      "tokensBought": 33459077.35908401,
      "tokensSold": 33448568.99984185,
      "totalTrades": 160919,
      "tradePercentage": 0.903806570263029,
      "trades24h": 1751,
      "trades30d": 63881,
      "trades7d": 8497,
      "updatedAt": "2026-09-21T07:30:16.663Z",
      "volume24h": 810695.4140489998,
      "volume30d": 15969317.696546001,
      "volume7d": 4779512.143639
    },
    {
      "_id": "6a54b75d7690aa46ea34ce0a",
      "address": "r3cpW3M3nKHfSgkJiEh1BaAy6GJXeZvMLU",
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "actualBalance": 2378.919938135023,
      "ammTokensBought": 1761901.4003773916,
      "ammTrades": 8730,
      "ammVolume": 2572396.0733800083,
      "avgBuyPrice": 0.810548590599814,
      "avgHoldingTime": 595.3416443114726,
      "avgSellPrice": 0.811067071737958,
      "balanceLastUpdated": "2026-09-21T07:29:54.501Z",
      "buyCount": 97390,
      "buyVolume": 25861334.626350056,
      "dexTokensBought": 30144062.1237855,
      "dexTrades": 164904,
      "dexVolume": 49164886.13603486,
      "firstTradeDate": 1776353782000,
      "inferredReceived": 0,
      "lastTradeDate": 1789975791000,
      "profit24h": 17052.512982000004,
      "profit30d": 13856.31201800006,
      "profit7d": 15688.991371000036,
      "sellCount": 76244,
      "sellRatio": 43.910754806086366,
      "sellVolume": 25875947.58306481,
      "sourceTagStats": [],
      "suspiciousActivity": true,
      "tokenDeposited": 0,
      "tokenWithdrawn": 0,
      "tokensBought": 31905964.58533583,
      "tokensSold": 31903585.393546563,
      "totalTrades": 173634,
      "tradePercentage": 0.975221530202639,
      "trades24h": 1965,
      "trades30d": 67354,
      "trades7d": 9115,
      "updatedAt": "2026-09-21T07:29:54.501Z",
      "volume24h": 780832.4131459997,
      "volume30d": 14760342.191725997,
      "volume7d": 4643888.140120999
    },
    {
      "_id": "6a54b7a57690aa46ea34deee",
      "address": "rKYdJJLAgxbJcn9Ria2X5jMMiqP91r4qy",
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "actualBalance": 5308.006613353767,
      "ammTokensBought": 908072.9381833684,
      "ammTrades": 8283,
      "ammVolume": 1328299.5654550036,
      "avgBuyPrice": 0.775741423093597,
      "avgHoldingTime": 70.40756527921444,
      "avgSellPrice": 0.77608836678307,
      "balanceLastUpdated": "2026-09-21T07:28:05.425Z",
      "buyCount": 89843,
      "buyVolume": 11311770.820840048,
      "dexTokensBought": 13673810.25652679,
      "dexTrades": 155967,
      "dexVolume": 21297038.03935506,
      "firstTradeDate": 1782147122000,
      "inferredReceived": 1103.4219742329196,
      "lastTradeDate": 1789975681000,
      "profit24h": 1973.1009329999943,
      "profit30d": 381.50003600002276,
      "profit7d": -1131.1376190000028,
      "sellCount": 74407,
      "sellRatio": 45.30106544901065,
      "sellVolume": 11313566.783970015,
      "sourceTagStats": [],
      "suspiciousActivity": true,
      "tokenDeposited": 0,
      "tokenWithdrawn": 0,
      "tokensBought": 14581883.194710132,
      "tokensSold": 14577678.61007101,
      "totalTrades": 164250,
      "tradePercentage": 0.922517826077335,
      "trades24h": 2627,
      "trades30d": 81352,
      "trades7d": 12113,
      "updatedAt": "2026-09-21T07:28:05.426Z",
      "volume24h": 777350.3612929998,
      "volume30d": 13465241.632592,
      "volume7d": 4494691.4380910015
    }
  ],
  "total": 45018,
  "page": 1,
  "limit": 50,
  "totalPages": 901
}

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}