GET /traders/token-traders/{id}
GET

/v1/traders/token-traders/{id}

Top traders for a token

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/traders/token-traders/0dd550278b74cb6690fdae351e8e0df3
Path parameterValueDescription
idA token id: its md5, slug or issuer_currency
Query parameterValueDescription
interval24h|7d|30d|all
sortByvolume|pnl|trades|bought|sold|roi|wash|lastActive|unrealized|balance
limitint (max 500, default 50)
offsetint
minVolumefloat (filters all-time buyVolume)
searchaddress prefix
curl 'https://api.xrpl.to/v1/traders/token-traders/0dd550278b74cb6690fdae351e8e0df3'

Response

200Example response197 ms · just now · 5.7 KB · 173 lines
https://api.xrpl.to/v1/traders/token-traders/0dd550278b74cb6690fdae351e8e0df3
{
  "success": true,
  "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
  "interval": "all",
  "traders": [
    {
      "address": "rfmdBKhtJw2J22rw1JxQcchQTM68qzE4N2",
      "volume": 663427095.0140126,
      "trades": 1854265,
      "profit": 15771439.33745231,
      "roi": -0.01871676544831235,
      "xrpBought": 323743210.0345455,
      "xrpSold": 339683884.97946703,
      "volumeAll": 663427095.0140126,
      "tradesAll": 1854265,
      "profitAll": 15771439.33745231,
      "roiAll": -0.01871676544831235,
      "xrpBoughtAll": 323743210.0345455,
      "xrpSoldAll": 339683884.97946703,
      "tokensBought": 696490788.269817,
      "tokensSold": 735098314.663384,
      "buyCount": 841615,
      "sellCount": 1012650,
      "avgBuyPrice": 0.46482051950575,
      "avgSellPrice": 0.46209313530397,
      "avgBuyMcap": 357241105.1239206,
      "avgSellMcap": 355144954.66271156,
      "lastTradeDate": 1774018641000,
      "firstTradeDate": 1734440410000,
      "washTradingScore": 100,
      "suspiciousActivity": true,
      "actualBalance": 0.001010201,
      "unrealizedPnl": 0.00038233784947676796,
      "holdingValue": 0.0010821587273009549,
      "totalPnl": 15771439.337834647,
      "totalRoi": -0.01871676544831235
    },
    {
      "address": "rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ",
      "volume": 450026214.5322435,
      "trades": 1353558,
      "profit": 186863.55727025727,
      "roi": -0.21436141661418398,
      "xrpBought": 224971029.14864686,
      "xrpSold": 225055185.3835966,
      "volumeAll": 450026214.5322435,
      "tradesAll": 1353558,
      "profitAll": 186863.55727025727,
      "roiAll": -0.21436141661418398,
      "xrpBoughtAll": 224971029.14864686,
      "xrpSoldAll": 225055185.3835966,
      "tokensBought": 358654874.784307,
      "tokensSold": 359419751.232375,
      "buyCount": 655797,
      "sellCount": 697761,
      "avgBuyPrice": 0.627263268856845,
      "avgSellPrice": 0.626162542853946,
      "avgBuyMcap": 482087631.6052787,
      "avgSellMcap": 481241660.8333076,
      "lastTradeDate": 1795234590000,
      "firstTradeDate": 1734541501000,
      "washTradingScore": 60,
      "suspiciousActivity": true,
      "actualBalance": 91506.01196476084,
      "unrealizedPnl": -4683.236568744178,
      "holdingValue": 98024.08574944148,
      "totalPnl": 182180.3207015131,
      "totalRoi": -0.21436141661418398
    },
    {
      "address": "rm9oxnf2QRUckx5YDVYHMCN1stbu1ngjW",
      "volume": 187245148.23381442,
      "trades": 517762,
      "profit": 3181924.1949452534,
      "roi": -1.0468787129649189,
      "xrpBought": 92099622.66986609,
      "xrpSold": 95145525.56394835,
      "volumeAll": 187245148.23381442,
      "tradesAll": 517762,
      "profitAll": 3181924.1949452534,
      "roiAll": -1.0468787129649189,
      "xrpBoughtAll": 92099622.66986609,
      "xrpSoldAll": 95145525.56394835,
      "tokensBought": 114884357.237627,
      "tokensSold": 119243332.660265,
      "buyCount": 206966,
      "sellCount": 310796,
      "avgBuyPrice": 0.801672437261122,
      "avgSellPrice": 0.797910654132975,
      "avgBuyMcap": 616131034.2733426,
      "avgSellMcap": 613239889.1849874,
      "lastTradeDate": 1785853861000,
      "firstTradeDate": 1774020211000,
      "washTradingScore": 100,
      "suspiciousActivity": true,
      "actualBalance": 0,
      "unrealizedPnl": 0,
      "holdingValue": 0,
      "totalPnl": 3181924.1949452534,
      "totalRoi": -1.0468787129649189
    },
    {
      "address": "rnUdnfhAZEbULVvR5sZEssrTYYvS9xE2sv",
      "volume": 166675447.13709885,
      "trades": 379582,
      "profit": 174800.0119179958,
      "roi": 0.007976100163557152,
      "xrpBought": 83250973.2619738,
      "xrpSold": 83424473.87512505,
      "volumeAll": 166675447.13709885,
      "tradesAll": 379582,
      "profitAll": 174800.0119179958,
      "roiAll": 0.007976100163557152,
      "xrpBoughtAll": 83250973.2619738,
      "xrpSoldAll": 83424473.87512505,
      "tokensBought": 159197325.92385,
      "tokensSold": 159356693.538433,
      "buyCount": 187714,
      "sellCount": 191868,
      "avgBuyPrice": 0.5229420329698,
      "avgSellPrice": 0.523507811455721,
      "avgBuyMcap": 401910806.288254,
      "avgSellMcap": 402345639.3541021,
      "lastTradeDate": 1795280631000,
      "firstTradeDate": 1755206511000,
      "washTradingScore": 0,
      "suspiciousActivity": false,
      "actualBalance": 1205.850826060207,
      "unrealizedPnl": -7.65386153346526,
      "holdingValue": 1291.7449054634858,
      "totalPnl": 174792.35805646234,
      "totalRoi": 0.007976100163557152
    },
    {
      "address": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns",
      "volume": 141787540.6214226,
      "trades": 438382,
      "profit": 4499212.318899687,
      "roi": 1.3046114213019908,
      "xrpBought": 69052776.90233016,
      "xrpSold": 72734763.71909241,
      "volumeAll": 141787540.6214226,
      "tradesAll": 438382,
      "profitAll": 4499212.318899687,
      "roiAll": 1.3046114213019908,
      "xrpBoughtAll": 69052776.90233016,
      "xrpSoldAll": 72734763.71909241,
      "tokensBought": 86207232.1225439,
      "tokensSold": 90428494.776632,
      "buyCount": 195188,
      "sellCount": 243194,
      "avgBuyPrice": 0.801009094041801,
      "avgSellPrice": 0.804334561785586,
      "avgBuyMcap": 615621217.1400571,
      "avgSellMcap": 618177028.9469603,
      "lastTradeDate": 1795282232000,
      "firstTradeDate": 1785151650000,
      "washTradingScore": 100,
      "suspiciousActivity": true,
      "actualBalance": 363674.3044511284,
      "unrealizedPnl": -5038.500383608742,
      "holdingValue": 224626.91473468926,
      "totalPnl": 4494173.818516078,
      "totalRoi": 1.3046114213019908
    }
  ],
  "count": 50,
  "total": 47667,
  "offset": 0,
  "sortBy": "volume",
  "limit": 50,
  "responseTime": "196ms"
}

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

Shapeas documented
{
  success,
  tokenId,
  interval,
  traders[],
  count (rows in this response),
  total (matching traders),
  offset,
  sortBy,
  limit
}

What it does

Top traders for a token

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