GET

/v1/token/analytics/traders

All traders with cumulative stats

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/token/analytics/traders

Query parameter	Value	Description
offset		int
limit		int (max 500, default 50)
sort		volume24h\|volume7d\|totalVolume\|totalProfit\|totalTrades\|avgROI\|winRate\|lastTradeDate\|washTradingScore\|activityScore (unknown values fall back to volume24h)
order		asc\|desc
period		24h\|7d\|30d\|all
startDate		ISO
endDate		ISO
minVolume		float (filters volume24h)
minTrades		int
minProfit		float
minROI		float
minTokens		int
address		partial match
includeAMM		bool (default true)
sourceTag		int
compact		bool

curl 'https://api.xrpl.to/v1/token/analytics/traders'

Response

200Example response12 ms · just now · 6.8 KB · 229 lines

https://api.xrpl.to/v1/token/analytics/traders

{
  "data": [
    {
      "_id": "6a54b6807690aa46ea3468d9",
      "address": "rN9QmppA5vJNChm9G3LJeh6Y9JiBkrbj9C",
      "activeTokens24h": 0,
      "activeTokens30d": 1,
      "activeTokens7d": 0,
      "ammTrades": 5377,
      "ammVolume": 1714176.044483001,
      "avgHoldingTime": 4351.809590444312,
      "buyCount": 19026,
      "buyVolume": 9836608.784348978,
      "dexTrades": 32889,
      "dexVolume": 17957221.17976799,
      "firstTradeDate": 1763618621000,
      "lastTradeDate": 1787418822000,
      "liquidityPositions": [],
      "profit24h": 0,
      "profit30d": -12583.671886000006,
      "profit7d": 0,
      "sellCount": 19240,
      "sellRatio": 50.27962159619506,
      "sellVolume": 9834788.439901998,
      "sourceTagStats": [],
      "suspiciousActivity": false,
      "totalLiquidityXrp": 0,
      "totalTrades": 38266,
      "trades24h": 0,
      "trades30d": 9947,
      "trades7d": 0,
      "updatedAt": "2026-08-22T17:13:49.239Z",
      "volume24h": 0,
      "volume30d": 4390384.169482001,
      "volume7d": 0,
      "washSelfTrades": 0,
      "washTradingScore": 0,
      "xrpBalance": 45.745986,
      "closedPositions": 19236,
      "fifoUpdatedAt": "2026-09-14T07:38:56.626Z",
      "grossLoss": 17539.72789822015,
      "grossProfit": 26489.60809023117,
      "lastFifoTime": 1787418822000
    },
    {
      "_id": "6a54b6fa7690aa46ea34859e",
      "address": "ra8sxREcsJ2NvGJaJTy78PMy9uzLFxwKrK",
      "activeTokens24h": 0,
      "activeTokens30d": 1,
      "activeTokens7d": 0,
      "ammTrades": 1718,
      "ammVolume": 679682.3668679997,
      "avgHoldingTime": 5680.733278818176,
      "buyCount": 9179,
      "buyVolume": 4291699.617401998,
      "dexTrades": 15145,
      "dexVolume": 7897933.943640006,
      "firstTradeDate": 1735566291000,
      "lastTradeDate": 1787419220000,
      "liquidityPositions": [],
      "profit24h": 0,
      "profit30d": -9183.671667000024,
      "profit7d": 0,
      "sellCount": 7684,
      "sellRatio": 45.5672181699579,
      "sellVolume": 4285916.693105997,
      "sourceTagStats": [],
      "suspiciousActivity": true,
      "totalLiquidityXrp": 0,
      "totalTrades": 16863,
      "trades24h": 0,
      "trades30d": 9247,
      "trades7d": 0,
      "updatedAt": "2026-08-22T17:20:23.209Z",
      "volume24h": 0,
      "volume30d": 4147907.8821830014,
      "volume7d": 0,
      "washSelfTrades": 0,
      "washTradingScore": 60,
      "xrpBalance": 614.231568,
      "closedPositions": 7684,
      "fifoUpdatedAt": "2026-09-14T07:38:57.429Z",
      "grossLoss": 8539.359330898906,
      "grossProfit": 11906.400058245752,
      "lastFifoTime": 1787419220000
    },
    {
      "_id": "6a54b6fa7690aa46ea34859d",
      "address": "rBus8r29i65UbFoFUvv9C9iNioqrDNgJXC",
      "activeTokens24h": 0,
      "activeTokens30d": 1,
      "activeTokens7d": 0,
      "ammTrades": 1913,
      "ammVolume": 769771.570606,
      "avgHoldingTime": 6710.518509005875,
      "buyCount": 8761,
      "buyVolume": 4455886.298319001,
      "dexTrades": 15013,
      "dexVolume": 8135859.421177992,
      "firstTradeDate": 1735533300000,
      "lastTradeDate": 1787419251000,
      "liquidityPositions": [],
      "profit24h": 0,
      "profit30d": -10594.577010999988,
      "profit7d": 0,
      "sellCount": 8165,
      "sellRatio": 48.23939501358856,
      "sellVolume": 4449744.693465007,
      "sourceTagStats": [],
      "suspiciousActivity": false,
      "totalLiquidityXrp": 0,
      "totalTrades": 16926,
      "trades24h": 0,
      "trades30d": 9272,
      "trades7d": 0,
      "updatedAt": "2026-08-22T17:20:54.800Z",
      "volume24h": 0,
      "volume30d": 4283781.095967001,
      "volume7d": 0,
      "washSelfTrades": 0,
      "washTradingScore": 0,
      "xrpBalance": 124.017124,
      "closedPositions": 8165,
      "fifoUpdatedAt": "2026-09-14T07:38:57.335Z",
      "grossLoss": 9118.014716907543,
      "grossProfit": 13655.32837490216,
      "lastFifoTime": 1787419251000
    },
    {
      "_id": "6a54b5537690aa46ea33d8b7",
      "address": "rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ",
      "activeTokens24h": 1,
      "activeTokens30d": 1,
      "activeTokens7d": 1,
      "ammTrades": 30470,
      "ammVolume": 8814929.924512982,
      "avgHoldingTime": 1545.9852263854375,
      "buyCount": 555465,
      "buyVolume": 182062014.92910352,
      "dexTrades": 1071219,
      "dexVolume": 355480715.8243889,
      "firstTradeDate": 1701484851000,
      "lastTradeDate": 1789975890000,
      "liquidityPositions": [],
      "profit24h": -978.9201020000037,
      "profit30d": 35752.58587199997,
      "profit7d": 1042.1319959999669,
      "sellCount": 546224,
      "sellRatio": 49.58059851736743,
      "sellVolume": 182233630.81979835,
      "sourceTagStats": [],
      "suspiciousActivity": false,
      "totalLiquidityXrp": 0,
      "totalTrades": 1101689,
      "trades24h": 5924,
      "trades30d": 166868,
      "trades7d": 45847,
      "updatedAt": "2026-09-21T07:31:31.658Z",
      "volume24h": 2454955.024658003,
      "volume30d": 57145709.142916,
      "volume7d": 19012523.059141994,
      "washSelfTrades": 0,
      "washTradingScore": 0,
      "xrpBalance": 89914.656823,
      "closedPositions": 544465,
      "fifoUpdatedAt": "2026-09-21T07:31:31.700Z",
      "grossLoss": 3846687.581029155,
      "grossProfit": 3373357.4949940112,
      "lastFifoTime": 1789975890000
    },
    {
      "_id": "6a54b5d07690aa46ea342eb7",
      "address": "rKNgkpShkm7Nf1JmC2sxRM2wjuzngGQUR4",
      "activeTokens24h": 0,
      "activeTokens30d": 1,
      "activeTokens7d": 0,
      "ammTrades": 1909,
      "ammVolume": 307601.53652,
      "avgHoldingTime": 40130.407054101175,
      "buyCount": 4500,
      "buyVolume": 1388966.021680001,
      "dexTrades": 6199,
      "dexVolume": 2466372.895964001,
      "firstTradeDate": 1734371131000,
      "lastTradeDate": 1787419450000,
      "liquidityPositions": [],
      "profit24h": 0,
      "profit30d": -9550.906623000006,
      "profit7d": 0,
      "sellCount": 3608,
      "sellRatio": 44.4992599901332,
      "sellVolume": 1385008.410804,
      "sourceTagStats": [],
      "suspiciousActivity": false,
      "totalLiquidityXrp": 0,
      "totalTrades": 8108,
      "trades24h": 0,
      "trades30d": 6233,
      "trades7d": 0,
      "updatedAt": "2026-08-22T17:24:25.261Z",
      "volume24h": 0,
      "volume30d": 2329829.4655370004,
      "volume7d": 0,
      "washSelfTrades": 0,
      "washTradingScore": 0,
      "xrpBalance": 0,
      "closedPositions": 3566,
      "fifoUpdatedAt": "2026-09-14T07:38:57.002Z",
      "grossLoss": 98465.49639872463,
      "grossProfit": 61721.635898935674,
      "lastFifoTime": 1787419450000
    }
  ],
  "pagination": {
    "total": 403157,
    "page": 1,
    "limit": 50,
    "totalPages": 8064,
    "hasNextPage": true,
    "hasPrevPage": false
  },
  "filters": {
    "minVolume": 0
  },
  "sorting": {
    "field": "volume24h",
    "order": "desc"
  }
}

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

What it does

All traders with cumulative stats

Each token comes back with its md5, the id every Token endpoint takes. Go to Token →

OpenAPI

PrevGET/token/analytics/sources NextGET/token/analytics/traders/summary

/v1/token/analytics/traders

Request

Response

What it does

Also under Top traders