GET /v1/traders/{account}

Request

GEThttps://api.xrpl.to/v1/traders/rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ

Path parameter	Value	Description
account		An XRPL account, its r-address

Query parameter	Value	Description
limit		int (max 200, default 50)
offset		int
sortTokensBy		volume\|profit\|trades\|roi\|lastTradeDate
tokenIds		comma-separated token md5s (filter, skips pagination)

curl 'https://api.xrpl.to/v1/traders/rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ'

Response

200Example response5 ms · just now · 6.6 KB · 239 lines

https://api.xrpl.to/v1/traders/rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ

{
  "success": true,
  "_id": "6ad17d93f6db4d31142fdbf8",
  "address": "rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ",
  "activeTokens24h": 1,
  "activeTokens30d": 1,
  "activeTokens7d": 1,
  "ammTrades": 32339,
  "ammVolume": 9398955.201606002,
  "buyCount": 622971,
  "buyVolume": 204797833.94892707,
  "dexTrades": 1224975,
  "dexVolume": 400366198.3628545,
  "firstTradeDate": 1701484851000,
  "lastTradeDate": 1793516192000,
  "liquidityPositions": [],
  "profit24h": 48942.60467900005,
  "profit30d": 5297.560445999869,
  "profit7d": -1683.9818039999614,
  "roiHistory": [
    {
      "date": "2025-11-02T00:00:00.000Z",
      "profit": 88218.96504499998,
      "volume": 170849.01944699997
    },
    {
      "date": "2025-11-03T00:00:00.000Z",
      "profit": -1088.5727610000015,
      "volume": 610878.8361690002
    },
    {
      "date": "2025-11-04T00:00:00.000Z",
      "profit": 1052.746711,
      "volume": 1793811.0206790008
    },
    {
      "date": "2025-11-05T00:00:00.000Z",
      "profit": 1354.0066079999938,
      "volume": 1072284.6940139998
    },
    {
      "date": "2025-11-06T00:00:00.000Z",
      "profit": -1024.2654410000066,
      "volume": 661949.8820809999
    }
  ],
  "sellCount": 634343,
  "sellRatio": 50.45223388906829,
  "sellVolume": 204967319.61553338,
  "sourceTagStats": [],
  "suspiciousActivity": true,
  "tokenPerformance": [
    {
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "name": "RLUSD",
      "currency": "524C555344000000000000000000000000000000",
      "profit": 169296.4334330016,
      "realizedPnl": 187600.5826469512,
      "unrealizedPnl": 41.52387298535541,
      "volume": 409764893.44802946,
      "trades": 1257306,
      "roi": -0.23414585290885753,
      "tokensBought": 338326144.908399,
      "tokensSold": 339159534.782001,
      "xrpBought": 204797798.50729808,
      "xrpSold": 204967094.94073138,
      "avgBuyPrice": 0.605326551286028,
      "avgSellPrice": 0.604338294874937,
      "firstTradeDate": 1734541501000,
      "lastTradeDate": 1793516192000,
      "stats24h": {
        "volume": 313452.2911969999,
        "trades": 1312,
        "profit": 48942.60467900004,
        "roi": 37.00628534499397,
        "buyVolume": 132254.84325899993,
        "sellVolume": 181197.44793799997
      },
      "stats7d": {
        "volume": 5043611.249024,
        "trades": 17347,
        "profit": -1683.9818039992824,
        "roi": -0.066754539703038,
        "buyVolume": 2522647.6154139997,
        "sellVolume": 2520963.6336100004
      },
      "stats30d": {
        "volume": 24231591.989254005,
        "trades": 76334,
        "profit": 5297.560446003452,
        "roi": 0.043733972288424,
        "buyVolume": 12113147.214404,
        "sellVolume": 12118444.774850003
      },
      "actualBalance": 22992.5862126879,
      "holdingValue": 18345.67308685688,
      "totalPnl": 187642.10651993655,
      "totalRoi": -0.23310593032638038,
      "avgEntry": 0.7960891847725605,
      "entryQty": 22992.5862126879
    },
    {
      "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
      },
      "actualBalance": 4475.7598,
      "holdingValue": 0,
      "totalPnl": 189.233173,
      "totalRoi": -100,
      "avgEntry": 1.8702903988432595,
      "entryQty": 18.9498
    }
  ],
  "totalLiquidityXrp": 0,
  "totalTrades": 1257314,
  "tradeHistory": [
    {
      "date": "2025-11-02T00:00:00.000Z",
      "trades": 645,
      "cumulativeTrades": 645
    },
    {
      "date": "2025-11-03T00:00:00.000Z",
      "trades": 1675,
      "cumulativeTrades": 2320
    },
    {
      "date": "2025-11-04T00:00:00.000Z",
      "trades": 3722,
      "cumulativeTrades": 6042
    },
    {
      "date": "2025-11-05T00:00:00.000Z",
      "trades": 2407,
      "cumulativeTrades": 8449
    },
    {
      "date": "2025-11-06T00:00:00.000Z",
      "trades": 2010,
      "cumulativeTrades": 10459
    }
  ],
  "trades24h": 1312,
  "trades30d": 76334,
  "trades7d": 17347,
  "updatedAt": "2026-11-01T06:56:36.314Z",
  "volume24h": 313452.291197,
  "volume30d": 24231591.989254,
  "volume7d": 5043611.249023998,
  "volumeHistory": [
    {
      "date": "2025-11-02T00:00:00.000Z",
      "h24Volume": 170849.01944699997,
      "h24BuyVolume": 41315.02720099998,
      "h24SellVolume": 129533.992246,
      "cumulativeVolume": 170849.01944699997,
      "cumulativeBuyVolume": 41315.02720099998,
      "cumulativeSellVolume": 129533.992246
    },
    {
      "date": "2025-11-03T00:00:00.000Z",
      "h24Volume": 610878.8361690002,
      "h24BuyVolume": 305983.70446499996,
      "h24SellVolume": 304895.13170400023,
      "cumulativeVolume": 781727.8556160002,
      "cumulativeBuyVolume": 347298.7316659999,
      "cumulativeSellVolume": 434429.1239500002
    },
    {
      "date": "2025-11-04T00:00:00.000Z",
      "h24Volume": 1793811.0206790008,
      "h24BuyVolume": 896379.1369840007,
      "h24SellVolume": 897431.8836950002,
      "cumulativeVolume": 2575538.8762950012,
      "cumulativeBuyVolume": 1243677.8686500005,
      "cumulativeSellVolume": 1331861.0076450005
    },
    {
      "date": "2025-11-05T00:00:00.000Z",
      "h24Volume": 1072284.6940139998,
      "h24BuyVolume": 535465.343703,
      "h24SellVolume": 536819.3503109998,
      "cumulativeVolume": 3647823.570309001,
      "cumulativeBuyVolume": 1779143.2123530004,
      "cumulativeSellVolume": 1868680.3579560001
    },
    {
      "date": "2025-11-06T00:00:00.000Z",
      "h24Volume": 661949.8820809999,
      "h24BuyVolume": 331487.0737609998,
      "h24SellVolume": 330462.8083200002,
      "cumulativeVolume": 4309773.452390001,
      "cumulativeBuyVolume": 2110630.2861140002,
      "cumulativeSellVolume": 2199143.1662760004
    }
  ],
  "washSelfTrades": 0,
  "washTradingScore": 60,
  "xrpBalance": 86793.352381,
  "avgHoldingTime": 141432.92820064496
}

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

Shapeas documented

{
  success,
  address,
  rank,
  totalTokensTraded,
  holdingValue,
  tokenPerformance[],
  recentTokens[],
  pagination: {
    totalTokens (servable,
    capped 500),
    lifetimeTokens,
    truncated,
    limit,
    offset,
    hasMore
  }
}

What it does

Full trader profile

An account is its r-address, e.g. rN7n3473SaZBCG4dFL83w7a1RXtXtbk2D9.

OpenAPI

/v1/traders/{account}

Request

Response

What it does

Also under Trading stats