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 response109 ms · just now · 7.3 KB · 218 lines
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

A token id can be its md5, slug or issuer_currency. How to build an md5 →
OpenAPI