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 response146 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": 313851.7524131995,
      "ammTokensBought": 172902.361703211,
      "ammTrades": 1100,
      "ammVolume": 323971.4046399998,
      "avgBuyPrice": 0.778048099364553,
      "avgHoldingTime": 0.899751267714087,
      "avgSellPrice": 0.779619021780137,
      "balanceLastUpdated": "2026-10-12T00:58:16.558Z",
      "buyCount": 149674,
      "buyVolume": 40317846.66374581,
      "dexTokensBought": 1664281.81141435,
      "dexTrades": 339034,
      "dexVolume": 82628758.63420275,
      "firstTradeDate": 1785151650000,
      "inferredReceived": 3181448.197028228,
      "lastTradeDate": 1791766691000,
      "profit24h": -9654.837036999976,
      "profit30d": -585801.0199509987,
      "profit7d": -700528.7226549994,
      "sellCount": 190460,
      "sellRatio": 55.995578213292404,
      "sellVolume": 42634883.37509694,
      "sourceTagStats": [],
      "suspiciousActivity": true,
      "tokenDeposited": 0,
      "tokenWithdrawn": 0,
      "tokensBought": 51819221.3266432,
      "tokensSold": 54686817.7712582,
      "totalTrades": 340134,
      "tradePercentage": 1.778853083410195,
      "trades24h": 2137,
      "trades30d": 120305,
      "trades7d": 27874,
      "updatedAt": "2026-10-12T00:58:16.558Z",
      "volume24h": 440460.649729,
      "volume30d": 13948688.994993005,
      "volume7d": 10682195.936945006
    },
    {
      "_id": "6a54b5517690aa46ea33b0f2",
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "address": "rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ",
      "actualBalance": 29425.50808857833,
      "ammTokensBought": 7400751.13992256,
      "ammTrades": 31694,
      "ammVolume": 9246555.09862198,
      "avgBuyPrice": 0.600176142120038,
      "avgHoldingTime": 1414.716364683641,
      "avgSellPrice": 0.599189963471299,
      "balanceLastUpdated": "2026-10-12T00:46:10.662Z",
      "buyCount": 603051,
      "buyVolume": 196621363.00791407,
      "dexTokensBought": 63666393.9026177,
      "dexTrades": 1172219,
      "dexVolume": 384168367.1655394,
      "firstTradeDate": 1734541501000,
      "inferredReceived": 855998.7417665616,
      "lastTradeDate": 1791765970000,
      "profit24h": -541.8937109999983,
      "profit30d": -1244.275681999914,
      "profit7d": 777.0488720000183,
      "sellCount": 600862,
      "sellRatio": 49.909088115171116,
      "sellVolume": 196793559.25624728,
      "sourceTagStats": [],
      "suspiciousActivity": true,
      "tokenDeposited": 0,
      "tokenWithdrawn": 0,
      "tokensBought": 327606096.292626,
      "tokensSold": 328432669.526304,
      "totalTrades": 1203913,
      "tradePercentage": 6.296380982425657,
      "trades24h": 906,
      "trades30d": 149861,
      "trades7d": 12928,
      "updatedAt": "2026-10-12T00:46:10.663Z",
      "volume24h": 263134.35511899996,
      "volume30d": 48939220.09600201,
      "volume7d": 5326858.912250002
    },
    {
      "_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": "6a54b7237690aa46ea34c205",
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "address": "rDi2VysuPsU5oQRGPDTPiR9YPd34kzK9m8",
      "actualBalance": 3330.734295974133,
      "ammTokensBought": 2420983.4391864,
      "ammTrades": 12865,
      "ammVolume": 3547486.305677007,
      "avgBuyPrice": 0.776222150071735,
      "avgHoldingTime": 459.4810307803338,
      "avgSellPrice": 0.77658020988599,
      "balanceLastUpdated": "2026-10-12T00:59:49.187Z",
      "buyCount": 149955,
      "buyVolume": 33918793.45391274,
      "dexTokensBought": 41275072.6140607,
      "dexTrades": 257756,
      "dexVolume": 64303160.245273255,
      "firstTradeDate": 1774029232000,
      "inferredReceived": 0,
      "lastTradeDate": 1791766782000,
      "profit24h": 18175.627759000003,
      "profit30d": 15087.786882999808,
      "profit7d": -1642.9589220000016,
      "sellCount": 120666,
      "sellRatio": 44.588557429024355,
      "sellVolume": 33931853.097037524,
      "sourceTagStats": [],
      "suspiciousActivity": true,
      "tokenDeposited": 0,
      "tokenWithdrawn": 0,
      "tokensBought": 43697275.9032683,
      "tokensSold": 43693945.1521937,
      "totalTrades": 270621,
      "tradePercentage": 1.415307924826937,
      "trades24h": 468,
      "trades30d": 41758,
      "trades7d": 7516,
      "updatedAt": "2026-10-12T00:59:49.187Z",
      "volume24h": 139063.171473,
      "volume30d": 13559734.793190999,
      "volume7d": 3312614.0359320007
    },
    {
      "_id": "6aabf790f6db4d3114aad5f5",
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "address": "r3nVVxJfkdvjiXP1tov5pZdht96JMwGApP",
      "actualBalance": 21.0105096704716,
      "ammTokensBought": 233526.078858848,
      "ammTrades": 2439,
      "ammVolume": 307103.056699,
      "avgBuyPrice": 0.680885317138596,
      "avgHoldingTime": 0.006025955755697,
      "avgSellPrice": 0.68116575909093,
      "balanceLastUpdated": "2026-10-12T00:58:28.729Z",
      "buyCount": 12909,
      "buyVolume": 1507139.055233,
      "dexTokensBought": 1979973.04837554,
      "dexTrades": 22905,
      "dexVolume": 2707781.500143996,
      "firstTradeDate": 1789654922000,
      "inferredReceived": 5.0050964e-8,
      "lastTradeDate": 1791766702000,
      "profit24h": 3468.658085999999,
      "profit30d": 606.4463769999933,
      "profit7d": 261.59582899999566,
      "sellCount": 12435,
      "sellRatio": 49.06486742424242,
      "sellVolume": 1507745.501609996,
      "sourceTagStats": [],
      "suspiciousActivity": true,
      "tokenDeposited": 0,
      "tokenWithdrawn": 0,
      "tokensBought": 2213499.1272344,
      "tokensSold": 2213478.11672478,
      "totalTrades": 25344,
      "tradePercentage": 0.132545549196396,
      "trades24h": 620,
      "trades30d": 25344,
      "trades7d": 7089,
      "updatedAt": "2026-10-12T00:58:28.729Z",
      "volume24h": 122281.608992,
      "volume30d": 3014884.5568430005,
      "volume7d": 1316927.591801
    }
  ],
  "total": 45983,
  "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}