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 response272 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": 663424797.5705774,
      "trades": 1854247,
      "profit": 15765987.035688747,
      "roi": -0.01885523999654153,
      "xrpBought": 323743029.7983104,
      "xrpSold": 339681767.772267,
      "volumeAll": 663424797.5705774,
      "tradesAll": 1854247,
      "profitAll": 15765987.035688747,
      "roiAll": -0.01885523999654153,
      "xrpBoughtAll": 323743029.7983104,
      "xrpSoldAll": 339681767.772267,
      "tokensBought": 696490437.4689507,
      "tokensSold": 735094252.8458827,
      "buyCount": 841613,
      "sellCount": 1012634,
      "avgBuyPrice": 0.464820494843828,
      "avgSellPrice": 0.462092808448994,
      "avgBuyMcap": 481731425.3897803,
      "avgSellMcap": 478904501.2984896,
      "lastTradeDate": 1774018641000,
      "firstTradeDate": 1734440410000,
      "washTradingScore": 100,
      "suspiciousActivity": true,
      "actualBalance": 0.001010201,
      "unrealizedPnl": 0.0000013191741144853676,
      "holdingValue": 0.0007011438183433497,
      "totalPnl": 15765987.035690065,
      "totalRoi": -0.01885523999654153
    },
    {
      "address": "rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ",
      "volume": 364289782.57565284,
      "trades": 1101672,
      "profit": 193781.03077627625,
      "roi": -0.25912439888786953,
      "xrpBought": 182060023.11602354,
      "xrpSold": 182229759.45962933,
      "volumeAll": 364289782.57565284,
      "tradesAll": 1101672,
      "profitAll": 193781.03077627625,
      "roiAll": -0.25912439888786953,
      "xrpBoughtAll": 182060023.11602354,
      "xrpSoldAll": 182229759.45962933,
      "tokensBought": 305740993.38696414,
      "tokensSold": 306563054.24067855,
      "buyCount": 555460,
      "sellCount": 546212,
      "avgBuyPrice": 0.595471418797063,
      "avgSellPrice": 0.594428313978194,
      "avgBuyMcap": 617135643.8410989,
      "avgSellMcap": 616054589.1612842,
      "lastTradeDate": 1789975820000,
      "firstTradeDate": 1734541501000,
      "washTradingScore": 0,
      "suspiciousActivity": false,
      "actualBalance": 33937.88804680508,
      "unrealizedPnl": -489.6318746250654,
      "holdingValue": 23555.05529260616,
      "totalPnl": 193291.39890165118,
      "totalRoi": -0.25912439888786953
    },
    {
      "address": "rm9oxnf2QRUckx5YDVYHMCN1stbu1ngjW",
      "volume": 187245155.32833722,
      "trades": 517762,
      "profit": 3195775.8507873164,
      "roi": -1.0323670294349492,
      "xrpBought": 92099623.2185656,
      "xrpSold": 95145532.10977162,
      "volumeAll": 187245155.32833722,
      "tradesAll": 517762,
      "profitAll": 3195775.8507873164,
      "roiAll": -1.0323670294349492,
      "xrpBoughtAll": 92099623.2185656,
      "xrpSoldAll": 95145532.10977162,
      "tokensBought": 114884357.83374846,
      "tokensSold": 119243339.82190919,
      "buyCount": 206966,
      "sellCount": 310796,
      "avgBuyPrice": 0.801672437877751,
      "avgSellPrice": 0.797910661106565,
      "avgBuyMcap": 830838593.5613765,
      "avgSellMcap": 826939957.1929641,
      "lastTradeDate": 1785853861000,
      "firstTradeDate": 1774020211000,
      "washTradingScore": 100,
      "suspiciousActivity": true,
      "actualBalance": 0,
      "unrealizedPnl": 0,
      "holdingValue": 0,
      "totalPnl": 3195775.8507873164,
      "totalRoi": -1.0323670294349492
    },
    {
      "address": "rnUdnfhAZEbULVvR5sZEssrTYYvS9xE2sv",
      "volume": 165174691.18382895,
      "trades": 371549,
      "profit": 173973.48753157392,
      "roi": 0.0070788507898459484,
      "xrpBought": 82500358.84814894,
      "xrpSold": 82674332.33568,
      "volumeAll": 165174691.18382895,
      "tradesAll": 371549,
      "profitAll": 173973.48753157392,
      "roiAll": 0.0070788507898459484,
      "xrpBoughtAll": 82500358.84814894,
      "xrpSoldAll": 82674332.33568,
      "tokensBought": 158268535.4873676,
      "tokensSold": 158429085.14204705,
      "buyCount": 183056,
      "sellCount": 188493,
      "avgBuyPrice": 0.521268226777394,
      "avgSellPrice": 0.52183809722539,
      "avgBuyMcap": 540232818.2199594,
      "avgSellMcap": 540823421.487771,
      "lastTradeDate": 1789975172000,
      "firstTradeDate": 1755206511000,
      "washTradingScore": 0,
      "suspiciousActivity": false,
      "actualBalance": 8.045022e-7,
      "unrealizedPnl": -1.7549240073840353e-8,
      "holdingValue": 5.583757533140683e-7,
      "totalPnl": 173973.48753155637,
      "totalRoi": 0.0070788507898459484
    },
    {
      "address": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns",
      "volume": 70585844.2975684,
      "trades": 252661,
      "profit": 3218618.3148608143,
      "roi": 1.5094578351908394,
      "xrpBought": 33798847.53044624,
      "xrpSold": 36786996.76712216,
      "volumeAll": 70585844.2975684,
      "tradesAll": 252661,
      "profitAll": 3218618.3148608143,
      "roiAll": 1.5094578351908394,
      "xrpBoughtAll": 33798847.53044624,
      "xrpSoldAll": 36786996.76712216,
      "tokensBought": 42466402.174855605,
      "tokensSold": 46268626.90577043,
      "buyCount": 103276,
      "sellCount": 149385,
      "avgBuyPrice": 0.795896186151119,
      "avgSellPrice": 0.795074313360802,
      "avgBuyMcap": 824852192.3408031,
      "avgSellMcap": 824000418.4729114,
      "lastTradeDate": 1789975802000,
      "firstTradeDate": 1785151650000,
      "washTradingScore": 100,
      "suspiciousActivity": true,
      "actualBalance": 396174.8674317312,
      "unrealizedPnl": -2690.5815313656058,
      "holdingValue": 116564.91769004264,
      "totalPnl": 3215927.733329449,
      "totalRoi": 1.5094578351908394
    }
  ],
  "count": 50,
  "total": 45018,
  "offset": 0,
  "sortBy": "volume",
  "limit": 50,
  "responseTime": "270ms"
}

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