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 response3 ms · just now · 6.2 KB · 227 lines
https://api.xrpl.to/v1/token/analytics/trader/rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ
{
  "_id": "6ad17d93f6db4d31142fdbf8",
  "address": "rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ",
  "activeTokens24h": 1,
  "activeTokens30d": 1,
  "activeTokens7d": 1,
  "ammTrades": 33401,
  "ammVolume": 9656049.545037007,
  "buyCount": 655799,
  "buyVolume": 224971064.59027585,
  "dexTrades": 1320165,
  "dexVolume": 440370425.10363746,
  "firstTradeDate": 1701484851000,
  "lastTradeDate": 1795234590000,
  "liquidityPositions": [],
  "profit24h": -89754.29014699995,
  "profit30d": -85377.70514199948,
  "profit7d": -86594.36522099994,
  "roiHistory": [
    {
      "date": "2025-11-22T00:00:00.000Z",
      "profit": 39421.84996399999,
      "volume": 992481.9725680001
    },
    {
      "date": "2025-11-23T00:00:00.000Z",
      "profit": 152454.4512969992,
      "volume": 603866.3786850004
    },
    {
      "date": "2025-11-24T00:00:00.000Z",
      "profit": -58779.20864299806,
      "volume": 1418005.773643
    },
    {
      "date": "2025-11-25T00:00:00.000Z",
      "profit": -134145.8376829998,
      "volume": 803777.2696209999
    },
    {
      "date": "2025-11-26T00:00:00.000Z",
      "profit": 1435.7421389999956,
      "volume": 399055.15404499974
    }
  ],
  "sellCount": 697767,
  "sellRatio": 51.55027534675073,
  "sellVolume": 225055410.0583986,
  "sourceTagStats": [],
  "suspiciousActivity": true,
  "tokenPerformance": [
    {
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "name": "RLUSD",
      "currency": "524C555344000000000000000000000000000000",
      "profit": 84156.23495200177,
      "realizedPnl": 186863.55727025727,
      "unrealizedPnl": 2085.669867247416,
      "volume": 450026214.5322435,
      "trades": 1353558,
      "roi": -0.21355596694304385,
      "tokensBought": 358654874.784307,
      "tokensSold": 359419751.232375,
      "xrpBought": 224971029.14864686,
      "xrpSold": 225055185.3835966,
      "avgBuyPrice": 0.627263268856845,
      "avgSellPrice": 0.626162542853946,
      "firstTradeDate": 1734541501000,
      "lastTradeDate": 1795234590000,
      "stats24h": {
        "volume": 5804042.8491870025,
        "trades": 8959,
        "profit": -89754.29014700558,
        "roi": -3.045720374323834,
        "buyVolume": 2946898.569667004,
        "sellVolume": 2857144.2795199985
      },
      "stats7d": {
        "volume": 25114611.454617016,
        "trades": 42915,
        "profit": -86594.36522100493,
        "roi": -0.687223983170195,
        "buyVolume": 12600602.90991901,
        "sellVolume": 12514008.544698006
      },
      "stats30d": {
        "volume": 47635299.17194201,
        "trades": 121153,
        "profit": -85377.70514200255,
        "roi": -0.357822691249385,
        "buyVolume": 23860338.43854201,
        "sellVolume": 23774960.733400006
      }
    },
    {
      "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.76353847723705,
      "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": 1353566,
  "tradeHistory": [
    {
      "date": "2025-11-22T00:00:00.000Z",
      "trades": 2551,
      "cumulativeTrades": 2551
    },
    {
      "date": "2025-11-23T00:00:00.000Z",
      "trades": 3193,
      "cumulativeTrades": 5744
    },
    {
      "date": "2025-11-24T00:00:00.000Z",
      "trades": 6316,
      "cumulativeTrades": 12060
    },
    {
      "date": "2025-11-25T00:00:00.000Z",
      "trades": 2413,
      "cumulativeTrades": 14473
    },
    {
      "date": "2025-11-26T00:00:00.000Z",
      "trades": 1253,
      "cumulativeTrades": 15726
    }
  ],
  "trades24h": 8959,
  "trades30d": 121153,
  "trades7d": 42915,
  "updatedAt": "2026-11-21T04:16:35.455Z",
  "volume24h": 5804042.849187,
  "volume30d": 47635299.17194199,
  "volume7d": 25114611.454616986,
  "volumeHistory": [
    {
      "date": "2025-11-22T00:00:00.000Z",
      "h24Volume": 992481.9725680001,
      "h24BuyVolume": 476530.06130199984,
      "h24SellVolume": 515951.91126600024,
      "cumulativeVolume": 992481.9725680001,
      "cumulativeBuyVolume": 476530.06130199984,
      "cumulativeSellVolume": 515951.91126600024
    },
    {
      "date": "2025-11-23T00:00:00.000Z",
      "h24Volume": 603866.3786850004,
      "h24BuyVolume": 225705.9636940003,
      "h24SellVolume": 378160.414991,
      "cumulativeVolume": 1596348.3512530006,
      "cumulativeBuyVolume": 702236.0249960001,
      "cumulativeSellVolume": 894112.3262570002
    },
    {
      "date": "2025-11-24T00:00:00.000Z",
      "h24Volume": 1418005.773643,
      "h24BuyVolume": 738392.4911429997,
      "h24SellVolume": 679613.2825000002,
      "cumulativeVolume": 3014354.1248960006,
      "cumulativeBuyVolume": 1440628.5161389997,
      "cumulativeSellVolume": 1573725.6087570004
    },
    {
      "date": "2025-11-25T00:00:00.000Z",
      "h24Volume": 803777.2696209999,
      "h24BuyVolume": 468961.55365199986,
      "h24SellVolume": 334815.7159690001,
      "cumulativeVolume": 3818131.3945170008,
      "cumulativeBuyVolume": 1909590.0697909996,
      "cumulativeSellVolume": 1908541.3247260004
    },
    {
      "date": "2025-11-26T00:00:00.000Z",
      "h24Volume": 399055.15404499974,
      "h24BuyVolume": 198809.7059529998,
      "h24SellVolume": 200245.44809199992,
      "cumulativeVolume": 4217186.5485620005,
      "cumulativeBuyVolume": 2108399.7757439995,
      "cumulativeSellVolume": 2108786.7728180005
    }
  ],
  "washSelfTrades": 0,
  "washTradingScore": 60,
  "xrpBalance": 0.6,
  "avgHoldingTime": 137570.50810439078,
  "closedPositions": 696007
}

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