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

Request

GEThttps://api.xrpl.to/v1/traders/token-traders/0dd550278b74cb6690fdae351e8e0df3

Path parameter	Value	Description
id		A token id: its md5, slug or issuer_currency

Query parameter	Value	Description
interval		24h\|7d\|30d\|all
sortBy		volume\|pnl\|trades\|bought\|sold\|roi\|wash\|lastActive\|unrealized\|balance
limit		int (max 500, default 50)
offset		int
minVolume		float (filters all-time buyVolume)
search		address prefix

curl 'https://api.xrpl.to/v1/traders/token-traders/0dd550278b74cb6690fdae351e8e0df3'

Response

200Example response248 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.01871676554432051,
      "xrpBought": 323743210.0345455,
      "xrpSold": 339683884.97946703,
      "volumeAll": 663427095.0140126,
      "tradesAll": 1854265,
      "profitAll": 15771439.33745231,
      "roiAll": -0.01871676554432051,
      "xrpBoughtAll": 323743210.0345455,
      "xrpSoldAll": 339683884.97946703,
      "tokensBought": 696490788.269817,
      "tokensSold": 735098314.663384,
      "buyCount": 841615,
      "sellCount": 1012650,
      "avgBuyPrice": 0.46482051950575,
      "avgSellPrice": 0.46209313530397,
      "avgBuyMcap": 474230077.3720542,
      "avgSellMcap": 471447481.58129877,
      "lastTradeDate": 1774018641000,
      "firstTradeDate": 1734440410000,
      "washTradingScore": 100,
      "suspiciousActivity": true,
      "actualBalance": 0.001010201,
      "unrealizedPnl": 0.00007075640417181315,
      "holdingValue": 0.0007705772819960001,
      "totalPnl": 15771439.337523066,
      "totalRoi": -0.01871676554432051
    },
    {
      "address": "rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ",
      "volume": 400091277.2489997,
      "trades": 1222220,
      "profit": 190667.69576198363,
      "roi": -0.2373747062178898,
      "xrpBought": 199958659.24922705,
      "xrpSold": 200132617.9997727,
      "volumeAll": 400091277.2489997,
      "tradesAll": 1222220,
      "profitAll": 190667.69576198363,
      "roiAll": -0.2373747062178898,
      "xrpBoughtAll": 199958659.24922705,
      "xrpSoldAll": 200132617.9997727,
      "tokensBought": 332034536.580709,
      "tokensSold": 332869359.437698,
      "buyCount": 611590,
      "sellCount": 610630,
      "avgBuyPrice": 0.60222247151878,
      "avgSellPrice": 0.601234725652875,
      "avgBuyMcap": 614413515.0642976,
      "avgSellMcap": 613405773.8421369,
      "lastTradeDate": 1792398880000,
      "firstTradeDate": 1734541501000,
      "washTradingScore": 60,
      "suspiciousActivity": true,
      "actualBalance": 21559.60277013761,
      "unrealizedPnl": -263.366461254529,
      "holdingValue": 16445.57875464989,
      "totalPnl": 190404.3293007291,
      "totalRoi": -0.2373747062178898
    },
    {
      "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": 817901030.6034526,
      "avgSellMcap": 814063096.1124905,
      "lastTradeDate": 1785853861000,
      "firstTradeDate": 1774020211000,
      "washTradingScore": 100,
      "suspiciousActivity": true,
      "actualBalance": 0,
      "unrealizedPnl": 0,
      "holdingValue": 0,
      "totalPnl": 3181924.1949452534,
      "totalRoi": -1.0468787129649189
    },
    {
      "address": "rnUdnfhAZEbULVvR5sZEssrTYYvS9xE2sv",
      "volume": 165767110.55698016,
      "trades": 375528,
      "profit": 174161.2991000684,
      "roi": 0.0072627015128666865,
      "xrpBought": 82796520.72698788,
      "xrpSold": 82970589.82999228,
      "volumeAll": 165767110.55698016,
      "tradesAll": 375528,
      "profitAll": 174161.2991000684,
      "roiAll": 0.0072627015128666865,
      "xrpBoughtAll": 82796520.72698788,
      "xrpSoldAll": 82970589.82999228,
      "tokensBought": 158705141.866925,
      "tokensSold": 158865591.994059,
      "buyCount": 185253,
      "sellCount": 190275,
      "avgBuyPrice": 0.521700303802464,
      "avgSellPrice": 0.522269100492793,
      "avgBuyMcap": 532261303.137686,
      "avgSellMcap": 532841614.2193708,
      "lastTradeDate": 1792398310000,
      "firstTradeDate": 1755206511000,
      "washTradingScore": 0,
      "suspiciousActivity": false,
      "actualBalance": 123.3382657259008,
      "unrealizedPnl": 1.8858396725022288,
      "holdingValue": 94.08193574265422,
      "totalPnl": 174163.1849397409,
      "totalRoi": 0.0072627015128666865
    },
    {
      "address": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns",
      "volume": 98084357.07658465,
      "trades": 372818,
      "profit": 2623761.930959046,
      "roi": -0.4657350009871294,
      "xrpBought": 48125215.576542936,
      "xrpSold": 49959141.500041716,
      "volumeAll": 98084357.07658465,
      "tradesAll": 372818,
      "profitAll": 2623761.930959046,
      "roiAll": -0.4657350009871294,
      "xrpBoughtAll": 48125215.576542936,
      "xrpSoldAll": 49959141.500041716,
      "tokensBought": 62144447.2498922,
      "tokensSold": 64362954.1090055,
      "buyCount": 165690,
      "sellCount": 207128,
      "avgBuyPrice": 0.774408940882911,
      "avgSellPrice": 0.776209578811914,
      "avgBuyMcap": 790085627.766634,
      "avgSellMcap": 791922716.7688539,
      "lastTradeDate": 1792398062000,
      "firstTradeDate": 1785151650000,
      "washTradingScore": 100,
      "suspiciousActivity": true,
      "actualBalance": 520121.2003653334,
      "unrealizedPnl": -8788.411040768377,
      "holdingValue": 396746.3711538749,
      "totalPnl": 2614973.5199182774,
      "totalRoi": -0.4657350009871294
    }
  ],
  "count": 50,
  "total": 46366,
  "offset": 0,
  "sortBy": "volume",
  "limit": 50,
  "responseTime": "243ms"
}

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

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

Request

Response

What it does

Also under Holders and traders