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 response11 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": 30470,
  "ammVolume": 8814929.924512982,
  "avgHoldingTime": 1545.9838231002789,
  "buyCount": 555465,
  "buyVolume": 182062014.92910352,
  "dexTrades": 1071220,
  "dexVolume": 355481527.6838189,
  "firstTradeDate": 1701484851000,
  "lastTradeDate": 1789975910000,
  "liquidityPositions": [],
  "profit24h": -167.0606720000037,
  "profit30d": 36564.44530199997,
  "profit7d": 1853.9914259999669,
  "roiHistory": [
    {
      "date": "2025-09-19T00:00:00.000Z",
      "profit": 238.5678219999998,
      "volume": 48870.233542
    },
    {
      "date": "2025-09-20T00:00:00.000Z",
      "profit": 587.2887300000018,
      "volume": 33917.650481999946
    },
    {
      "date": "2025-09-21T00:00:00.000Z",
      "profit": -430.0901840000003,
      "volume": 22811.81385000002
    },
    {
      "date": "2025-09-22T00:00:00.000Z",
      "profit": -277.55959200002854,
      "volume": 380332.17318000004
    },
    {
      "date": "2025-09-23T00:00:00.000Z",
      "profit": -44.2056869999967,
      "volume": 144233.51239500006
    }
  ],
  "sellCount": 546225,
  "sellRatio": 49.580644282874495,
  "sellVolume": 182234442.67922834,
  "sourceTagStats": [],
  "suspiciousActivity": false,
  "tokenPerformance": [
    {
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "name": "RLUSD",
      "currency": "524C555344000000000000000000000000000000",
      "profit": 172238.51695499945,
      "realizedPnl": 193733.1520476715,
      "unrealizedPnl": -359.4485275299776,
      "volume": 364296197.49190086,
      "trades": 1101682,
      "roi": -0.2600214788339236,
      "tokensBought": 305743804.18960285,
      "tokensSold": 306569459.2623786,
      "xrpBought": 182061979.48747453,
      "xrpSold": 182234218.00442633,
      "avgBuyPrice": 0.595472343160129,
      "avgSellPrice": 0.594430438188106,
      "firstTradeDate": 1734541501000,
      "lastTradeDate": 1789975910000,
      "stats24h": {
        "volume": 2455766.8840879994,
        "trades": 5925,
        "profit": -167.0606720012147,
        "roi": -0.013604655154318,
        "buyVolume": 1227966.9723800004,
        "sellVolume": 1227799.9117079992
      },
      "stats7d": {
        "volume": 19013334.91857201,
        "trades": 45848,
        "profit": 1853.9914260059595,
        "roi": 0.019503913799358,
        "buyVolume": 9505740.463573001,
        "sellVolume": 9507594.454999007
      },
      "stats30d": {
        "volume": 57146521.002346024,
        "trades": 166869,
        "profit": 36564.44530202076,
        "roi": 0.128049284245204,
        "buyVolume": 28554978.278522003,
        "sellVolume": 28591542.723824024
      }
    },
    {
      "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": 1101690,
  "tradeHistory": [
    {
      "date": "2025-09-19T00:00:00.000Z",
      "trades": 735,
      "cumulativeTrades": 735
    },
    {
      "date": "2025-09-20T00:00:00.000Z",
      "trades": 459,
      "cumulativeTrades": 1194
    },
    {
      "date": "2025-09-21T00:00:00.000Z",
      "trades": 374,
      "cumulativeTrades": 1568
    },
    {
      "date": "2025-09-22T00:00:00.000Z",
      "trades": 1968,
      "cumulativeTrades": 3536
    },
    {
      "date": "2025-09-23T00:00:00.000Z",
      "trades": 821,
      "cumulativeTrades": 4357
    }
  ],
  "trades24h": 5925,
  "trades30d": 166869,
  "trades7d": 45848,
  "updatedAt": "2026-09-21T07:31:52.243Z",
  "volume24h": 2455766.884088003,
  "volume30d": 57146521.002345994,
  "volume7d": 19013334.918571994,
  "volumeHistory": [
    {
      "date": "2025-09-19T00:00:00.000Z",
      "h24Volume": 48870.233542,
      "h24BuyVolume": 24315.83286000001,
      "h24SellVolume": 24554.40068199999,
      "cumulativeVolume": 48870.233542,
      "cumulativeBuyVolume": 24315.83286000001,
      "cumulativeSellVolume": 24554.40068199999
    },
    {
      "date": "2025-09-20T00:00:00.000Z",
      "h24Volume": 33917.650481999946,
      "h24BuyVolume": 16665.18087599995,
      "h24SellVolume": 17252.469605999995,
      "cumulativeVolume": 82787.88402399994,
      "cumulativeBuyVolume": 40981.013735999964,
      "cumulativeSellVolume": 41806.870287999984
    },
    {
      "date": "2025-09-21T00:00:00.000Z",
      "h24Volume": 22811.81385000002,
      "h24BuyVolume": 11620.952017,
      "h24SellVolume": 11190.861833000023,
      "cumulativeVolume": 105599.69787399996,
      "cumulativeBuyVolume": 52601.96575299997,
      "cumulativeSellVolume": 52997.73212100001
    },
    {
      "date": "2025-09-22T00:00:00.000Z",
      "h24Volume": 380332.17318000004,
      "h24BuyVolume": 190304.86638600007,
      "h24SellVolume": 190027.30679399995,
      "cumulativeVolume": 485931.871054,
      "cumulativeBuyVolume": 242906.83213900003,
      "cumulativeSellVolume": 243025.03891499995
    },
    {
      "date": "2025-09-23T00:00:00.000Z",
      "h24Volume": 144233.51239500006,
      "h24BuyVolume": 72138.85904100009,
      "h24SellVolume": 72094.65335399997,
      "cumulativeVolume": 630165.3834490001,
      "cumulativeBuyVolume": 315045.69118000014,
      "cumulativeSellVolume": 315119.69226899993
    }
  ],
  "washSelfTrades": 0,
  "washTradingScore": 0,
  "xrpBalance": 90730.316053,
  "closedPositions": 544466
}

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