GET
/v1/nft/analytics/traders
NFT trader leaderboard
AuthNone — works without a key
Request
GET
https://api.xrpl.to/v1/nft/analytics/traders| Query parameter | Value | Description |
|---|---|---|
| offset | int | |
| limit | int (max 100, default 50) | |
| sort | volume|profit|trades|roi|winRate|combinedProfit|lastTrade|xrpBalance | |
| order | asc|desc | |
| interval | 24h|7d|30d|all | |
| minVolume | number | |
| minTrades | number | |
| minProfit | number | |
| minROI | number | |
| address | substring | |
| marketplace | string (see /nft/analytics/marketplaces) |
curl 'https://api.xrpl.to/v1/nft/analytics/traders'
Response
200Example response48 ms · just now · 5.4 KB · 226 lines
https://api.xrpl.to/v1/nft/analytics/traders{ "success": true, "traders": [ { "_id": "rsvKyxzWw2ehGyAUAZifo2i8fBFbA8AP6q", "address": "rsvKyxzWw2ehGyAUAZifo2i8fBFbA8AP6q", "xrpBalance": 18.793254, "traderType": "buyer", "is24hActive": false, "buyVolume": 998000, "sellVolume": 0, "totalVolume": 998000, "buyCount": 14, "sellCount": 0, "totalTrades": 14, "profit": 0, "roi": 0, "unrealizedProfit": -998000, "unrealizedRoi": -100, "combinedProfit": -998000, "holdingsValue": 0, "holdingsCost": 998000, "holdingsCount": 14, "grossProfit": 0, "grossLoss": 0, "winningTrades": 0, "losingTrades": 0, "winRate": 0, "profitFactor": 0, "maxProfit": 0, "maxLoss": 0, "avgHoldingTime": 0, "avgHoldingDays": 0, "flips": 0, "firstTrade": 1679615870000, "lastTrade": 1679618840000, "vol24h": 0, "vol7d": 0, "vol30d": 0, "volAll": 998000, "profit24h": 0, "profit7d": 0, "profit30d": 0, "profitAll": 0 }, { "_id": "rPB5vNQJCfU5sN92tMxGi8ffABNkDKhKqs", "address": "rPB5vNQJCfU5sN92tMxGi8ffABNkDKhKqs", "xrpBalance": 120.806566, "traderType": "seller", "is24hActive": false, "buyVolume": 0, "sellVolume": 998000, "totalVolume": 998000, "buyCount": 0, "sellCount": 14, "totalTrades": 14, "profit": 0, "roi": 0, "unrealizedProfit": 0, "unrealizedRoi": 0, "combinedProfit": 0, "holdingsValue": 0, "holdingsCost": 0, "holdingsCount": 0, "grossProfit": 0, "grossLoss": 0, "winningTrades": 0, "losingTrades": 0, "winRate": 0, "profitFactor": 0, "maxProfit": 0, "maxLoss": 0, "avgHoldingTime": 0, "avgHoldingDays": 0, "flips": 0, "firstTrade": 1679615870000, "lastTrade": 1679618840000, "vol24h": 0, "vol7d": 0, "vol30d": 0, "volAll": 998000, "profit24h": 0, "profit7d": 0, "profit30d": 0, "profitAll": 0 }, { "_id": "rG5qYqxdmDmLkVnPrLcWKE6LYTMeFGhYy9", "address": "rG5qYqxdmDmLkVnPrLcWKE6LYTMeFGhYy9", "xrpBalance": 156.211744, "traderType": "seller", "is24hActive": false, "buyVolume": 0, "sellVolume": 780542, "totalVolume": 780542, "buyCount": 0, "sellCount": 2911, "totalTrades": 2911, "profit": 0, "roi": 0, "unrealizedProfit": 0, "unrealizedRoi": 0, "combinedProfit": 0, "holdingsValue": 0, "holdingsCost": 0, "holdingsCount": 0, "grossProfit": 0, "grossLoss": 0, "winningTrades": 0, "losingTrades": 0, "winRate": 0, "profitFactor": 0, "maxProfit": 0, "maxLoss": 0, "avgHoldingTime": 0, "avgHoldingDays": 0, "flips": 0, "firstTrade": 1667391672000, "lastTrade": 1680302061000, "vol24h": 0, "vol7d": 0, "vol30d": 0, "volAll": 780542, "profit24h": 0, "profit7d": 0, "profit30d": 0, "profitAll": 0 }, { "_id": "rDxThQhDkAaas4Mv22DWxUsZUZE1MfvRDf", "address": "rDxThQhDkAaas4Mv22DWxUsZUZE1MfvRDf", "xrpBalance": 0.830093, "traderType": "seller", "is24hActive": false, "buyVolume": 1803.002, "sellVolume": 768632, "totalVolume": 770435.002, "buyCount": 11, "sellCount": 1078, "totalTrades": 1089, "profit": 0, "roi": 0, "unrealizedProfit": -988.327449, "unrealizedRoi": -98.832547, "combinedProfit": -988.327449, "holdingsValue": 11.674551, "holdingsCost": 1000.002, "holdingsCount": 213, "grossProfit": 0, "grossLoss": 0, "winningTrades": 0, "losingTrades": 0, "winRate": 0, "profitFactor": 0, "maxProfit": 0, "maxLoss": 0, "avgHoldingTime": 0, "avgHoldingDays": 0, "flips": 0, "firstTrade": 1667766840000, "lastTrade": 1746044160000, "vol24h": 0, "vol7d": 0, "vol30d": 0, "volAll": 770435.002, "profit24h": 0, "profit7d": 0, "profit30d": 0, "profitAll": 0 }, { "_id": "rRVLLRSgfcuuDBA4GT7gfAmTXvovsvZCH", "address": "rRVLLRSgfcuuDBA4GT7gfAmTXvovsvZCH", "xrpBalance": 68.996725, "traderType": "seller", "is24hActive": false, "buyVolume": 0, "sellVolume": 754772.121872, "totalVolume": 754772.121872, "buyCount": 0, "sellCount": 1714, "totalTrades": 1714, "profit": 0, "roi": 0, "unrealizedProfit": 0, "unrealizedRoi": 0, "combinedProfit": 0, "holdingsValue": 0, "holdingsCost": 0, "holdingsCount": 0, "grossProfit": 0, "grossLoss": 0, "winningTrades": 0, "losingTrades": 0, "winRate": 0, "profitFactor": 0, "maxProfit": 0, "maxLoss": 0, "avgHoldingTime": 0, "avgHoldingDays": 0, "flips": 0, "firstTrade": 1670518920000, "lastTrade": 1732813001000, "vol24h": 0, "vol7d": 0, "vol30d": 0, "volAll": 754772.121872, "profit24h": 0, "profit7d": 0, "profit30d": 0, "profitAll": 0 } ], "pagination": { "offset": 0, "limit": 50, "total": 81798, "totalPages": 1636 }, "filters": { "sort": "volume", "order": "desc", "interval": "all" } }
Long arrays and strings are shortened in the example; Send request for the full answer.
What it does
NFT trader leaderboard
Each collection comes back with its slug, the id every Collection endpoint takes. To find one by name, use POST /search (under Token List): it covers collections and NFTs too. Go to Collection →