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 response4 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": 31890,
  "ammVolume": 9309521.162929004,
  "buyCount": 611531,
  "buyVolume": 199949974.04078007,
  "dexTrades": 1190237,
  "dexVolume": 390763725.37511975,
  "firstTradeDate": 1701484851000,
  "lastTradeDate": 1792392190000,
  "liquidityPositions": [],
  "profit24h": 2105.9893990000023,
  "profit30d": 3099.385444999883,
  "profit7d": 710.7588079999364,
  "roiHistory": [
    {
      "date": "2025-10-20T00:00:00.000Z",
      "profit": 48.68930199999861,
      "volume": 319706.19707
    },
    {
      "date": "2025-10-21T00:00:00.000Z",
      "profit": 439.1936149999989,
      "volume": 343650.28239900013
    },
    {
      "date": "2025-10-22T00:00:00.000Z",
      "profit": -619.2848170000021,
      "volume": 272830.38611900003
    },
    {
      "date": "2025-10-23T00:00:00.000Z",
      "profit": -362.5027810000039,
      "volume": 174451.906427
    },
    {
      "date": "2025-10-24T00:00:00.000Z",
      "profit": -1225.2998599995583,
      "volume": 628739.2323099994
    }
  ],
  "sellCount": 610596,
  "sellRatio": 49.96174701974508,
  "sellVolume": 200123272.49726868,
  "sourceTagStats": [],
  "suspiciousActivity": true,
  "tokenPerformance": [
    {
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "name": "RLUSD",
      "currency": "524C555344000000000000000000000000000000",
      "profit": 173109.22331599976,
      "realizedPnl": 190682.8472591819,
      "unrealizedPnl": -301.08370476737764,
      "volume": 400072986.42161775,
      "trades": 1222119,
      "roi": -0.23828079515390652,
      "tokensBought": 332023062.123866,
      "tokensSold": 332856766.083885,
      "xrpBought": 199949938.59915107,
      "xrpSold": 200123047.82246667,
      "avgBuyPrice": 0.602217018661664,
      "avgSellPrice": 0.601228721221285,
      "firstTradeDate": 1734541501000,
      "lastTradeDate": 1792392190000,
      "stats24h": {
        "volume": 763951.3005710001,
        "trades": 2662,
        "profit": 2105.9893990005367,
        "roi": 0.552865356816529,
        "buyVolume": 380922.6555859998,
        "sellVolume": 383028.6449850003
      },
      "stats7d": {
        "volume": 6663277.999116,
        "trades": 18215,
        "profit": 710.7588080014102,
        "roi": 0.021335883972814,
        "buyVolume": 3331283.6201539994,
        "sellVolume": 3331994.378962001
      },
      "stats30d": {
        "volume": 40423826.80645499,
        "trades": 132167,
        "profit": 3099.3854449801147,
        "roi": 0.015335624283541,
        "buyVolume": 20210363.710505,
        "sellVolume": 20213463.09594998
      }
    },
    {
      "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": 1222127,
  "tradeHistory": [
    {
      "date": "2025-10-20T00:00:00.000Z",
      "trades": 1098,
      "cumulativeTrades": 1098
    },
    {
      "date": "2025-10-21T00:00:00.000Z",
      "trades": 1209,
      "cumulativeTrades": 2307
    },
    {
      "date": "2025-10-22T00:00:00.000Z",
      "trades": 909,
      "cumulativeTrades": 3216
    },
    {
      "date": "2025-10-23T00:00:00.000Z",
      "trades": 601,
      "cumulativeTrades": 3817
    },
    {
      "date": "2025-10-24T00:00:00.000Z",
      "trades": 2288,
      "cumulativeTrades": 6105
    }
  ],
  "trades24h": 2662,
  "trades30d": 132167,
  "trades7d": 18215,
  "updatedAt": "2026-10-19T06:43:08.595Z",
  "volume24h": 763951.300570999,
  "volume30d": 40423826.80645499,
  "volume7d": 6663277.999115999,
  "volumeHistory": [
    {
      "date": "2025-10-20T00:00:00.000Z",
      "h24Volume": 319706.19707,
      "h24BuyVolume": 159828.75388400003,
      "h24SellVolume": 159877.44318599993,
      "cumulativeVolume": 319706.19707,
      "cumulativeBuyVolume": 159828.75388400003,
      "cumulativeSellVolume": 159877.44318599993
    },
    {
      "date": "2025-10-21T00:00:00.000Z",
      "h24Volume": 343650.28239900013,
      "h24BuyVolume": 171605.544392,
      "h24SellVolume": 172044.73800700012,
      "cumulativeVolume": 663356.4794690001,
      "cumulativeBuyVolume": 331434.2982760001,
      "cumulativeSellVolume": 331922.18119300005
    },
    {
      "date": "2025-10-22T00:00:00.000Z",
      "h24Volume": 272830.38611900003,
      "h24BuyVolume": 136724.835468,
      "h24SellVolume": 136105.55065100003,
      "cumulativeVolume": 936186.8655880002,
      "cumulativeBuyVolume": 468159.1337440001,
      "cumulativeSellVolume": 468027.73184400005
    },
    {
      "date": "2025-10-23T00:00:00.000Z",
      "h24Volume": 174451.906427,
      "h24BuyVolume": 87407.20460400001,
      "h24SellVolume": 87044.70182299998,
      "cumulativeVolume": 1110638.7720150002,
      "cumulativeBuyVolume": 555566.3383480001,
      "cumulativeSellVolume": 555072.433667
    },
    {
      "date": "2025-10-24T00:00:00.000Z",
      "h24Volume": 628739.2323099994,
      "h24BuyVolume": 314982.2660849995,
      "h24SellVolume": 313756.966225,
      "cumulativeVolume": 1739378.0043249996,
      "cumulativeBuyVolume": 870548.6044329996,
      "cumulativeSellVolume": 868829.399892
    }
  ],
  "washSelfTrades": 0,
  "washTradingScore": 60,
  "xrpBalance": 91347.503645,
  "avgHoldingTime": 140210.4484021919,
  "closedPositions": 608839
}

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