XRPL.to
GET /token/analytics/trader/{address}
GET

/v1/token/analytics/trader/{address}

Trader cumulative stats

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/token/analytics/trader/rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ
Path parameterValueDescription
addressAn XRPL account, its r-address
curl 'https://api.xrpl.to/v1/token/analytics/trader/rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ'

Response

200Example response5 ms · just now · 6.2 KB · 227 lines
https://api.xrpl.to/v1/token/analytics/trader/rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ
{
  "_id": "6a54b5537690aa46ea33d8b7",
  "address": "rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ",
  "activeTokens24h": 1,
  "activeTokens30d": 1,
  "activeTokens7d": 1,
  "ammTrades": 31694,
  "ammVolume": 9246555.09862198,
  "avgHoldingTime": 1414.703438718217,
  "buyCount": 603053,
  "buyVolume": 196621398.44954306,
  "dexTrades": 1172230,
  "dexVolume": 384168707.6818684,
  "firstTradeDate": 1701484851000,
  "lastTradeDate": 1791767011000,
  "liquidityPositions": [],
  "profit24h": -461.49381299999834,
  "profit30d": -1163.8757839999141,
  "profit7d": 857.4487700000183,
  "roiHistory": [
    {
      "date": "2025-10-10T00:00:00.000Z",
      "profit": -90025.59139900004,
      "volume": 437889.8742970007
    },
    {
      "date": "2025-10-14T00:00:00.000Z",
      "profit": 649.793476,
      "volume": 871.7491239999999
    },
    {
      "date": "2025-10-15T00:00:00.000Z",
      "profit": -1863.9233970000012,
      "volume": 400033.15330099966
    },
    {
      "date": "2025-10-16T00:00:00.000Z",
      "profit": 865.1063380000002,
      "volume": 717870.1007719995
    },
    {
      "date": "2025-10-17T00:00:00.000Z",
      "profit": 1279.1255890000039,
      "volume": 1023755.1451370001
    }
  ],
  "sellCount": 600871,
  "sellRatio": 49.90937966183912,
  "sellVolume": 196793864.33094728,
  "sourceTagStats": [],
  "suspiciousActivity": true,
  "tokenPerformance": [
    {
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "name": "RLUSD",
      "currency": "524C555344000000000000000000000000000000",
      "profit": 172276.6482350012,
      "realizedPnl": 193455.08743238216,
      "unrealizedPnl": -371.3174070316709,
      "volume": 393415002.66405934,
      "trades": 1203916,
      "roi": -0.2409063991699084,
      "tokensBought": 327606096.292626,
      "tokensSold": 328432782.777079,
      "xrpBought": 196621363.00791407,
      "xrpSold": 196793639.65614527,
      "avgBuyPrice": 0.600176142120038,
      "avgSellPrice": 0.599190001656191,
      "firstTradeDate": 1734541501000,
      "lastTradeDate": 1791767011000,
      "stats24h": {
        "volume": 263214.7550169999,
        "trades": 909,
        "profit": -461.49381300000823,
        "roi": -0.350045796728205,
        "buyVolume": 131838.12441499997,
        "sellVolume": 131376.63060199996
      },
      "stats7d": {
        "volume": 5326939.312148001,
        "trades": 12931,
        "profit": 857.4487700029276,
        "roi": 0.032198107051216,
        "buyVolume": 2663040.9316889993,
        "sellVolume": 2663898.380459002
      },
      "stats30d": {
        "volume": 48939300.49590002,
        "trades": 149864,
        "profit": -1163.8757839910686,
        "roi": -0.004756292360252,
        "buyVolume": 24470232.185842007,
        "sellVolume": 24469068.310058016
      }
    },
    {
      "tokenId": "2dcc7e07c7dcb3d23667abe448d57778",
      "name": "EUR",
      "currency": "EUR",
      "profit": 189.23317300000002,
      "realizedPnl": 224.674802,
      "unrealizedPnl": -35.441629,
      "volume": 260.116431,
      "trades": 8,
      "roi": 0,
      "tokensBought": 18.9498,
      "tokensSold": 127.4,
      "xrpBought": 35.441629,
      "xrpSold": 224.674802,
      "avgBuyPrice": 1.87029039884326,
      "avgSellPrice": 1.763538477237049,
      "firstTradeDate": 1701484851000,
      "lastTradeDate": 1704283831000,
      "stats24h": {
        "volume": 0,
        "trades": 0,
        "profit": 0,
        "roi": 0,
        "buyVolume": 0,
        "sellVolume": 0
      },
      "stats7d": {
        "volume": 0,
        "trades": 0,
        "profit": 0,
        "roi": 0,
        "buyVolume": 0,
        "sellVolume": 0
      },
      "stats30d": {
        "volume": 0,
        "trades": 0,
        "profit": 0,
        "roi": 0,
        "buyVolume": 0,
        "sellVolume": 0
      }
    }
  ],
  "totalLiquidityXrp": 0,
  "totalTrades": 1203924,
  "tradeHistory": [
    {
      "date": "2025-10-10T00:00:00.000Z",
      "trades": 1785,
      "cumulativeTrades": 1785
    },
    {
      "date": "2025-10-14T00:00:00.000Z",
      "trades": 5,
      "cumulativeTrades": 1790
    },
    {
      "date": "2025-10-15T00:00:00.000Z",
      "trades": 1270,
      "cumulativeTrades": 3060
    },
    {
      "date": "2025-10-16T00:00:00.000Z",
      "trades": 2184,
      "cumulativeTrades": 5244
    },
    {
      "date": "2025-10-17T00:00:00.000Z",
      "trades": 2668,
      "cumulativeTrades": 7912
    }
  ],
  "trades24h": 909,
  "trades30d": 149864,
  "trades7d": 12931,
  "updatedAt": "2026-10-12T01:03:35.320Z",
  "volume24h": 263214.75501700025,
  "volume30d": 48939300.495900005,
  "volume7d": 5326939.312147998,
  "volumeHistory": [
    {
      "date": "2025-10-10T00:00:00.000Z",
      "h24Volume": 437889.8742970007,
      "h24BuyVolume": 263957.7328480007,
      "h24SellVolume": 173932.141449,
      "cumulativeVolume": 437889.8742970007,
      "cumulativeBuyVolume": 263957.7328480007,
      "cumulativeSellVolume": 173932.141449
    },
    {
      "date": "2025-10-14T00:00:00.000Z",
      "h24Volume": 871.7491239999999,
      "h24BuyVolume": 110.977824,
      "h24SellVolume": 760.7713,
      "cumulativeVolume": 438761.6234210007,
      "cumulativeBuyVolume": 264068.7106720007,
      "cumulativeSellVolume": 174692.91274899998
    },
    {
      "date": "2025-10-15T00:00:00.000Z",
      "h24Volume": 400033.15330099966,
      "h24BuyVolume": 200948.53834899986,
      "h24SellVolume": 199084.6149519998,
      "cumulativeVolume": 838794.7767220004,
      "cumulativeBuyVolume": 465017.2490210006,
      "cumulativeSellVolume": 373777.52770099975
    },
    {
      "date": "2025-10-16T00:00:00.000Z",
      "h24Volume": 717870.1007719995,
      "h24BuyVolume": 358502.4972169998,
      "h24SellVolume": 359367.60355499963,
      "cumulativeVolume": 1556664.877494,
      "cumulativeBuyVolume": 823519.7462380005,
      "cumulativeSellVolume": 733145.1312559994
    },
    {
      "date": "2025-10-17T00:00:00.000Z",
      "h24Volume": 1023755.1451370001,
      "h24BuyVolume": 511238.0097740001,
      "h24SellVolume": 512517.1353630001,
      "cumulativeVolume": 2580420.022631,
      "cumulativeBuyVolume": 1334757.7560120006,
      "cumulativeSellVolume": 1245662.2666189997
    }
  ],
  "washSelfTrades": 0,
  "washTradingScore": 60,
  "xrpBalance": 90745.745942,
  "closedPositions": 599111
}

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

What it does

Trader cumulative stats

An account is its r-address, e.g. rN7n3473SaZBCG4dFL83w7a1RXtXtbk2D9.
OpenAPI
PrevGET/traders/{account}/rotationsNextGET/token/analytics/trader/{address}/tokens