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 response242 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": 554
  },
  "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": 1589,
      "volAll": 321496.046743,
      "profit24h": 0,
      "profit7d": 0,
      "profit30d": 0,
      "profitAll": -38798.693341,
      "trades24h": 0,
      "trades7d": 0,
      "trades30d": 1,
      "tradesAll": 1104,
      "globalProfit": -38798.693341,
      "globalRoi": -23.961672,
      "unrealizedProfit": 0.000554,
      "combinedProfit": -24010.456338,
      "winRate": 13.970588,
      "avgHoldingDays": 66.221565,
      "flips": 1,
      "holdingsCount": 1,
      "holdingsCost": 0,
      "holdingsValue": 0.000554
    },
    {
      "lastTrade": 1783832461000,
      "address": "r9YEwyeXiiaLWdLP25DLG7nP6SaTghUAsL",
      "volume": 105873.995424,
      "sales": 103,
      "profit": 5122.13621,
      "roi": 7.416046,
      "trades": 103,
      "buys": 64,
      "sells": 39,
      "buyVolume": 69068.293284,
      "sellVolume": 36805.70214,
      "vol24h": 0,
      "vol7d": 0,
      "vol30d": 0,
      "volAll": 114080.153274,
      "profit24h": 0,
      "profit7d": 0,
      "profit30d": 0,
      "profitAll": 5008.40961,
      "trades24h": 0,
      "trades7d": 0,
      "trades30d": 0,
      "tradesAll": 139,
      "globalProfit": 5008.40961,
      "globalRoi": 6.862295,
      "unrealizedProfit": 0.00554,
      "combinedProfit": 5122.14175,
      "winRate": 65.217391,
      "avgHoldingDays": 115.077839,
      "flips": 4,
      "holdingsCount": 10,
      "holdingsCost": 0,
      "holdingsValue": 0.00554
    },
    {
      "lastTrade": 1786516972000,
      "address": "rs8AJUQcw9gL4Q3QbY5Hyy6nBQVBmpZ1pB",
      "volume": 91501.292609,
      "sales": 77,
      "profit": 0,
      "roi": 0,
      "trades": 77,
      "buys": 77,
      "sells": 0,
      "buyVolume": 91501.292609,
      "sellVolume": 0,
      "vol24h": 0,
      "vol7d": 0,
      "vol30d": 33244.176363,
      "volAll": 219859.122645,
      "profit24h": 0,
      "profit7d": 0,
      "profit30d": 0,
      "profitAll": 89.906265,
      "trades24h": 0,
      "trades7d": 0,
      "trades30d": 88,
      "tradesAll": 1022,
      "globalProfit": 89.906265,
      "globalRoi": 0.040956,
      "unrealizedProfit": -81087.912005,
      "combinedProfit": -81087.912005,
      "winRate": 100,
      "avgHoldingDays": 23.01105,
      "flips": 0,
      "holdingsCount": 76,
      "holdingsCost": 81087.954109,
      "holdingsValue": 0.042104
    },
    {
      "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": 1481,
  "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}