/v1/traders/{account}
Full trader profile
Request
https://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
https://api.xrpl.to/v1/traders/rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ{ "success": true, "_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": -4683.236568744178, "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 }, "actualBalance": 91506.01196476084, "holdingValue": 98024.08574944148, "totalPnl": 182180.3207015131, "totalRoi": -0.21436141661418398, "avgEntry": 1.1224106494526116, "entryQty": 91506.01196476084 }, { "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": 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 }
Long arrays and strings are shortened in the example; Send request for the full answer.
{ success, address, rank, totalTokensTraded, holdingValue, tokenPerformance[], recentTokens[], pagination: { totalTokens (servable, capped 500), lifetimeTokens, truncated, limit, offset, hasMore } }