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 response10 ms · just now · 6.7 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-10-05T09:13:52.734Z",
      "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-10-05T09:13:53.975Z",
      "grossLoss": 17687.753662083152,
      "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-10-05T09:13:53.967Z",
      "grossLoss": 19796.03710344374,
      "grossProfit": 13655.32837490216,
      "lastFifoTime": 1787419251000
    },
    {
      "_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-10-05T09:13:53.356Z",
      "grossLoss": 110644.06733860583,
      "grossProfit": 61721.635898935674,
      "lastFifoTime": 1787419450000
    },
    {
      "_id": "6a54b6fa7690aa46ea34859c",
      "address": "rPVfAnRqiyK4fAfqRKbKytw1fBxZHRiPSr",
      "activeTokens24h": 0,
      "activeTokens30d": 1,
      "activeTokens7d": 0,
      "ammTrades": 1532,
      "ammVolume": 516909.04932200053,
      "avgHoldingTime": 8741.136287922309,
      "buyCount": 7031,
      "buyVolume": 3519161.354124003,
      "dexTrades": 12129,
      "dexVolume": 6515565.030479995,
      "firstTradeDate": 1735552781000,
      "lastTradeDate": 1787419200000,
      "liquidityPositions": [],
      "profit24h": 0,
      "profit30d": -10256.056227999998,
      "profit7d": 0,
      "sellCount": 6630,
      "sellRatio": 48.53231827831052,
      "sellVolume": 3513312.725678002,
      "sourceTagStats": [],
      "suspiciousActivity": false,
      "totalLiquidityXrp": 0,
      "totalTrades": 13661,
      "trades24h": 0,
      "trades30d": 6428,
      "trades7d": 0,
      "updatedAt": "2026-08-22T17:20:04.294Z",
      "volume24h": 0,
      "volume30d": 2779475.4965040013,
      "volume7d": 0,
      "washSelfTrades": 0,
      "washTradingScore": 0,
      "xrpBalance": 0,
      "closedPositions": 6630,
      "fifoUpdatedAt": "2026-10-05T09:13:53.965Z",
      "grossLoss": 18026.601715099223,
      "grossProfit": 12179.741126694602,
      "lastFifoTime": 1787419200000
    }
  ],
  "pagination": {
    "total": 406693,
    "page": 1,
    "limit": 50,
    "totalPages": 8134,
    "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