XRPL.to
GET /nft/analytics/collection/{slug}/traders
GET

/v1/nft/analytics/collection/{slug}/traders

Top traders for collection

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/nft/analytics/collection/fuzzybears/traders
Path parameterValueDescription
slugA collection slug, or its identity as issuer:taxon
Query parameterValueDescription
limitint (max 200, default 50)
pageint (1-based, default 1)
sortvolume|sales|profit|roi|globalVolume|globalProfit|combinedProfit|holdingsCount
orderasc|desc
interval24h|7d|30d|all
addresssubstring filter
curl 'https://api.xrpl.to/v1/nft/analytics/collection/fuzzybears/traders'

Response

200Example response186 ms · just now · 4.6 KB · 189 lines
https://api.xrpl.to/v1/nft/analytics/collection/fuzzybears/traders
{
  "collection": {
    "cid": "33920d4b2f0346fba52ece9f05c54f5f",
    "slug": "fuzzybears",
    "name": "Fuzzybears",
    "floor": 698
  },
  "traders": [
    {
      "lastTrade": 1764305060000,
      "address": "r1YT17CB2iN6P3k44ZpYvHMF5MznCvxxc",
      "volume": 120698.391781,
      "sales": 138,
      "profit": -24010.456892,
      "roi": -51.85404,
      "trades": 139,
      "buys": 28,
      "sells": 111,
      "buyVolume": 46303.927,
      "sellVolume": 74394.464781,
      "vol24h": 0,
      "vol7d": 0,
      "vol30d": 1206.87732,
      "volAll": 322702.924063,
      "profit24h": 0,
      "profit7d": 0,
      "profit30d": 0,
      "profitAll": -38606.690131,
      "trades24h": 0,
      "trades7d": 0,
      "trades30d": 1,
      "tradesAll": 1105,
      "globalProfit": -38606.690131,
      "globalRoi": -23.843093,
      "unrealizedProfit": 0.000698,
      "combinedProfit": -24010.456194,
      "winRate": 14.59854,
      "avgHoldingDays": 68.358807,
      "flips": 1,
      "holdingsCount": 1,
      "holdingsCost": 0,
      "holdingsValue": 0.000698
    },
    {
      "lastTrade": 1793302670000,
      "address": "r9YEwyeXiiaLWdLP25DLG7nP6SaTghUAsL",
      "volume": 111151.543974,
      "sales": 105,
      "profit": 8051.32555,
      "roi": 11.65705,
      "trades": 105,
      "buys": 64,
      "sells": 41,
      "buyVolume": 69068.293284,
      "sellVolume": 42083.25069,
      "vol24h": 0,
      "vol7d": 5277.54855,
      "vol30d": 5277.54855,
      "volAll": 119357.701824,
      "profit24h": 0,
      "profit7d": 0,
      "profit30d": 0,
      "profitAll": 7937.59895,
      "trades24h": 0,
      "trades7d": 2,
      "trades30d": 2,
      "tradesAll": 141,
      "globalProfit": 7937.59895,
      "globalRoi": 10.875736,
      "unrealizedProfit": 0.005584,
      "combinedProfit": 8051.331134,
      "winRate": 66.666667,
      "avgHoldingDays": 131.921581,
      "flips": 4,
      "holdingsCount": 8,
      "holdingsCost": 0,
      "holdingsValue": 0.005584
    },
    {
      "lastTrade": 1792849132000,
      "address": "rs8AJUQcw9gL4Q3QbY5Hyy6nBQVBmpZ1pB",
      "volume": 95056.907609,
      "sales": 78,
      "profit": 0,
      "roi": 0,
      "trades": 78,
      "buys": 78,
      "sells": 0,
      "buyVolume": 95056.907609,
      "sellVolume": 0,
      "vol24h": 0,
      "vol7d": 217.219632,
      "vol30d": 7477.785462,
      "volAll": 227357.225907,
      "profit24h": 0,
      "profit7d": 0,
      "profit30d": 0,
      "profitAll": 89.906265,
      "trades24h": 0,
      "trades7d": 2,
      "trades30d": 6,
      "tradesAll": 1032,
      "globalProfit": 89.906265,
      "globalRoi": 0.039603,
      "unrealizedProfit": -84643.515363,
      "combinedProfit": -84643.515363,
      "winRate": 100,
      "avgHoldingDays": 23.01105,
      "flips": 0,
      "holdingsCount": 77,
      "holdingsCost": 84643.569109,
      "holdingsValue": 0.053746
    },
    {
      "lastTrade": 1755318982000,
      "address": "rpayGUrJqgX2t1GMhiD5sx9TN6snfjxwvV",
      "volume": 79468.950145,
      "sales": 131,
      "profit": 2667.022614,
      "roi": 6.686388,
      "trades": 131,
      "buys": 65,
      "sells": 66,
      "buyVolume": 39887.343806,
      "sellVolume": 39581.606339,
      "vol24h": 0,
      "vol7d": 0,
      "vol30d": 0,
      "volAll": 113410.969097,
      "profit24h": 0,
      "profit7d": 0,
      "profit30d": 0,
      "profitAll": 1722.318908,
      "trades24h": 0,
      "trades7d": 0,
      "trades30d": 0,
      "tradesAll": 993,
      "globalProfit": 1722.318908,
      "globalRoi": 3.496919,
      "unrealizedProfit": 0,
      "combinedProfit": 2667.022614,
      "winRate": 32.270916,
      "avgHoldingDays": 4.077447,
      "flips": 42,
      "holdingsCount": 0,
      "holdingsCost": 0,
      "holdingsValue": 0
    },
    {
      "lastTrade": 1779842571000,
      "address": "rfDHVZ57zngfAwDxK5m9ZT19gnxGtz4vb8",
      "volume": 78904.374705,
      "sales": 115,
      "profit": -161.45497,
      "roi": -0.443662,
      "trades": 115,
      "buys": 46,
      "sells": 69,
      "buyVolume": 36391.400405,
      "sellVolume": 42512.9743,
      "vol24h": 0,
      "vol7d": 0,
      "vol30d": 0,
      "volAll": 213718.962923,
      "profit24h": 0,
      "profit7d": 0,
      "profit30d": 0,
      "profitAll": -42291.669283,
      "trades24h": 0,
      "trades7d": 0,
      "trades30d": 0,
      "tradesAll": 1848,
      "globalProfit": -42291.669283,
      "globalRoi": -42.83364,
      "unrealizedProfit": 0,
      "combinedProfit": -161.45497,
      "winRate": 31.662269,
      "avgHoldingDays": 472.820164,
      "flips": 50,
      "holdingsCount": 0,
      "holdingsCost": 0,
      "holdingsValue": 0
    }
  ],
  "count": 50,
  "page": 1,
  "total": 1544,
  "interval": "all"
}

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

What it does

Top traders for collection

A collection is its slug, or its on-chain identity as issuer:taxon. Each NFT in it comes back with its NFTokenID, the id every NFT endpoint takes. Go to NFT →
OpenAPI
PrevGET/nft/collections/{slug}/tradersNextGET/nft/analytics/rotations/{cid}