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 response6 ms · just now · 6.5 KB · 235 lines

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

{
  "success": true,
  "_id": "6a54b5537690aa46ea33d8b7",
  "address": "rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ",
  "activeTokens24h": 1,
  "activeTokens30d": 1,
  "activeTokens7d": 1,
  "ammTrades": 30470,
  "ammVolume": 8814929.924512982,
  "avgHoldingTime": 1545.9852263854375,
  "buyCount": 555465,
  "buyVolume": 182062014.92910352,
  "dexTrades": 1071219,
  "dexVolume": 355480715.8243889,
  "firstTradeDate": 1701484851000,
  "lastTradeDate": 1789975890000,
  "liquidityPositions": [],
  "profit24h": -978.9201020000037,
  "profit30d": 35752.58587199997,
  "profit7d": 1042.1319959999669,
  "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": 546224,
  "sellRatio": 49.58059851736743,
  "sellVolume": 182233630.81979835,
  "sourceTagStats": [],
  "suspiciousActivity": false,
  "tokenPerformance": [
    {
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "name": "RLUSD",
      "currency": "524C555344000000000000000000000000000000",
      "profit": 171426.65752499943,
      "realizedPnl": 193747.42680209305,
      "unrealizedPnl": -359.90104056744167,
      "volume": 364295385.63247085,
      "trades": 1101681,
      "roi": -0.2600148173030334,
      "tokensBought": 305743804.18960285,
      "tokensSold": 306568293.6839086,
      "xrpBought": 182061979.48747453,
      "xrpSold": 182233406.14499635,
      "avgBuyPrice": 0.595472343160129,
      "avgSellPrice": 0.594430050006706,
      "firstTradeDate": 1734541501000,
      "lastTradeDate": 1789975890000,
      "stats24h": {
        "volume": 2454955.0246579996,
        "trades": 5924,
        "profit": -978.9201020011678,
        "roi": -0.079718764756666,
        "buyVolume": 1227966.9723800004,
        "sellVolume": 1226988.0522779992
      },
      "stats7d": {
        "volume": 19012523.05914201,
        "trades": 45847,
        "profit": 1042.1319960057735,
        "roi": 0.01096318587699,
        "buyVolume": 9505740.463573001,
        "sellVolume": 9506782.595569007
      },
      "stats30d": {
        "volume": 57145709.142916024,
        "trades": 166868,
        "profit": 35752.58587202057,
        "roi": 0.125206139270336,
        "buyVolume": 28554978.278522003,
        "sellVolume": 28590730.864394024
      },
      "actualBalance": 30343.66898556377,
      "holdingValue": 21135.186565096756,
      "totalPnl": 193387.5257615256,
      "totalRoi": -0.259069213958214
    },
    {
      "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
      },
      "actualBalance": 4475.7598,
      "holdingValue": 0,
      "totalPnl": 189.233173,
      "totalRoi": -100
    }
  ],
  "totalLiquidityXrp": 0,
  "totalTrades": 1101689,
  "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": 5924,
  "trades30d": 166868,
  "trades7d": 45847,
  "updatedAt": "2026-09-21T07:31:31.658Z",
  "volume24h": 2454955.024658003,
  "volume30d": 57145709.142916,
  "volume7d": 19012523.059141994,
  "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": 89914.656823
}

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