GET /token/analytics/token/{id}/traders
GET

/v1/token/analytics/token/{id}/traders

Top traders for token

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/token/analytics/token/0dd550278b74cb6690fdae351e8e0df3/traders
Path parameterValueDescription
idA token id: its md5, slug or issuer_currency
Query parameterValueDescription
offsetint
limitint (max 100, default 50)
sortvolume24h|volume7d|volume30d|volumeTotal|trades24h|tradesTotal|realizedPnl|unrealizedPnl|totalPnl|holding|lastTradeAt|firstTradeAt
addressfilter
curl 'https://api.xrpl.to/v1/token/analytics/token/0dd550278b74cb6690fdae351e8e0df3/traders'

Response

200Example response168 ms · just now · 7.3 KB · 218 lines
https://api.xrpl.to/v1/token/analytics/token/0dd550278b74cb6690fdae351e8e0df3/traders
{
  "traders": [
    {
      "_id": "6ad18088f6db4d311430e90c",
      "address": "rURtT5MMFzSUR54MAq9MKfzBoezTBZbKns",
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "actualBalance": 520121.2003653334,
      "ammTokensBought": 185865.389492493,
      "ammTrades": 1135,
      "ammVolume": 341174.113031,
      "avgBuyPrice": 0.774408940882911,
      "avgSellPrice": 0.776209578811914,
      "balanceLastUpdated": "2026-10-19T08:21:08.099Z",
      "buyCount": 165690,
      "buyVolume": 48125215.576542936,
      "dexTokensBought": 1767192.53481088,
      "dexTrades": 371683,
      "dexVolume": 97743182.96355365,
      "firstTradeDate": 1785151650000,
      "inferredReceived": 2738628.059478639,
      "lastTradeDate": 1792398062000,
      "profit24h": 32561.813512000102,
      "profit30d": -1174783.7847820015,
      "profit7d": -499196.62903400033,
      "sellCount": 207128,
      "sellRatio": 55.55740334425913,
      "sellVolume": 49959141.500041716,
      "sourceTagStats": [],
      "suspiciousActivity": true,
      "tokenDeposited": 0,
      "tokenWithdrawn": 0,
      "tokensBought": 62144447.2498922,
      "tokensSold": 64362954.1090055,
      "totalTrades": 372818,
      "tradePercentage": 1.918316984518365,
      "trades24h": 4806,
      "trades30d": 127961,
      "trades7d": 32715,
      "updatedAt": "2026-10-19T08:21:08.099Z",
      "volume24h": 1542531.9897939996,
      "volume30d": 27848695.091554016,
      "volume7d": 15147541.219148,
      "washSelfTrades": 195
    },
    {
      "_id": "6ad17d92f6db4d31142fb436",
      "address": "rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ",
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "actualBalance": 21559.60277013761,
      "ammTokensBought": 7436197.30759177,
      "ammTrades": 31891,
      "ammVolume": 9309957.167429004,
      "avgBuyPrice": 0.60222247151878,
      "avgSellPrice": 0.601234725652875,
      "balanceLastUpdated": "2026-10-19T08:34:39.434Z",
      "buyCount": 611590,
      "buyVolume": 199958659.24922705,
      "dexTokensBought": 64136905.2155621,
      "dexTrades": 1190329,
      "dexVolume": 390781320.0815707,
      "firstTradeDate": 1734541501000,
      "inferredReceived": 856382.4597595213,
      "lastTradeDate": 1792398880000,
      "profit24h": 2955.516629000004,
      "profit30d": 3948.9126749998845,
      "profit7d": 1560.286037999938,
      "sellCount": 610630,
      "sellRatio": 49.960727201322186,
      "sellVolume": 200132617.9997727,
      "sourceTagStats": [],
      "suspiciousActivity": true,
      "tokenDeposited": 0,
      "tokenWithdrawn": 0,
      "tokensBought": 332034536.580709,
      "tokensSold": 332869359.437698,
      "totalTrades": 1222220,
      "tradePercentage": 6.288795579000686,
      "trades24h": 2763,
      "trades30d": 132268,
      "trades7d": 18316,
      "updatedAt": "2026-10-19T08:34:39.434Z",
      "volume24h": 782242.1279530001,
      "volume30d": 40442117.633836985,
      "volume7d": 6681568.826498001,
      "washSelfTrades": 0
    },
    {
      "_id": "6ad180cef6db4d311430f809",
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "address": "r3nVVxJfkdvjiXP1tov5pZdht96JMwGApP",
      "actualBalance": 3372.90524078904,
      "ammTokensBought": 383643.848532603,
      "ammTrades": 3564,
      "ammVolume": 523893.71265199984,
      "avgBuyPrice": 0.720688614870358,
      "avgSellPrice": 0.72099669300517,
      "balanceLastUpdated": "2026-10-19T08:31:02.432Z",
      "buyCount": 19059,
      "buyVolume": 3436311.1102919998,
      "dexTokensBought": 4384450.22065166,
      "dexTrades": 33974,
      "dexVolume": 6347765.599934995,
      "firstTradeDate": 1789654922000,
      "inferredReceived": 0,
      "lastTradeDate": 1792398661000,
      "profit24h": -1363.0116159999948,
      "profit30d": -912.6286169999952,
      "profit7d": -1582.2784879999922,
      "sellCount": 18479,
      "sellRatio": 49.22744951782194,
      "sellVolume": 3435348.2022949955,
      "sourceTagStats": [],
      "suspiciousActivity": true,
      "tokenDeposited": 0,
      "tokenWithdrawn": 0,
      "tokensBought": 4768094.0691843,
      "tokensSold": 4764721.16394348,
      "totalTrades": 37538,
      "tradePercentage": 0.193148850059934,
      "trades24h": 2098,
      "trades30d": 36581,
      "trades7d": 12219,
      "updatedAt": "2026-10-19T08:31:02.432Z",
      "volume24h": 569361.0472980002,
      "volume30d": 6856595.258071002,
      "volume7d": 3857364.389146001,
      "washSelfTrades": 0
    },
    {
      "_id": "6ad1801cf6db4d311430d27a",
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "address": "r3cpW3M3nKHfSgkJiEh1BaAy6GJXeZvMLU",
      "actualBalance": 26520.42871298479,
      "ammTokensBought": 2239299.45078693,
      "ammTrades": 11725,
      "ammVolume": 3176979.8770789984,
      "avgBuyPrice": 0.785863307310414,
      "avgSellPrice": 0.786366074873373,
      "balanceLastUpdated": "2026-10-19T08:17:03.439Z",
      "buyCount": 114370,
      "buyVolume": 31854349.300090007,
      "dexTokensBought": 38294910.7227026,
      "dexTrades": 196173,
      "dexVolume": 60531243.24427003,
      "firstTradeDate": 1776353782000,
      "inferredReceived": 0.000001354386768,
      "lastTradeDate": 1792397821000,
      "profit24h": -1171.066127999995,
      "profit30d": -8998.968554000163,
      "profit7d": -1527.5152489999673,
      "sellCount": 93528,
      "sellRatio": 44.98744576667404,
      "sellVolume": 31853873.82125901,
      "sourceTagStats": [],
      "suspiciousActivity": true,
      "tokenDeposited": 0,
      "tokenWithdrawn": 0,
      "tokensBought": 40534211.2346615,
      "tokensSold": 40507690.8059499,
      "totalTrades": 207898,
      "tradePercentage": 1.06974165207571,
      "trades24h": 1001,
      "trades30d": 37528,
      "trades7d": 7216,
      "updatedAt": "2026-10-19T08:17:03.439Z",
      "volume24h": 366030.6578680002,
      "volume30d": 13358070.063544003,
      "volume7d": 3427742.3611870017,
      "washSelfTrades": 0
    },
    {
      "_id": "6ad18060f6db4d311430e36b",
      "address": "rKYdJJLAgxbJcn9Ria2X5jMMiqP91r4qy",
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "actualBalance": 350.1553118871895,
      "ammTokensBought": 1381912.16928418,
      "ammTrades": 12258,
      "ammVolume": 1932203.635511999,
      "avgBuyPrice": 0.742253603668132,
      "avgSellPrice": 0.742530884370444,
      "balanceLastUpdated": "2026-10-19T08:34:54.911Z",
      "buyCount": 117436,
      "buyVolume": 17720493.696096055,
      "dexTokensBought": 22491995.088994,
      "dexTrades": 206402,
      "dexVolume": 33515143.529318076,
      "firstTradeDate": 1782147122000,
      "inferredReceived": 0,
      "lastTradeDate": 1792398891000,
      "profit24h": -316.01221199999145,
      "profit30d": 1891.5631609999382,
      "profit7d": 7310.854004000012,
      "sellCount": 101224,
      "sellRatio": 46.29287478276777,
      "sellVolume": 17726853.46873402,
      "sourceTagStats": [],
      "suspiciousActivity": true,
      "tokenDeposited": 0,
      "tokenWithdrawn": 0,
      "tokensBought": 23873907.2582786,
      "tokensSold": 23873557.1029665,
      "totalTrades": 218660,
      "tradePercentage": 1.125089748367035,
      "trades24h": 1599,
      "trades30d": 58763,
      "trades7d": 11372,
      "updatedAt": "2026-10-19T08:34:54.911Z",
      "volume24h": 356561.18707199994,
      "volume30d": 14173881.607626997,
      "volume7d": 3402650.168907999,
      "washSelfTrades": 0
    }
  ],
  "total": 46366,
  "page": 1,
  "limit": 50,
  "totalPages": 928
}

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

What it does

Top traders for token

A token id can be its md5, slug or issuer_currency. How to build an md5 →
OpenAPI